CakePHP Auditable

Este plugin inclui funções para tornar a auditoria de sistemas em CakePHP mais simples.
A ideia central é manter a informação de qual usuário fez o quê, e quando isso foi feito.

Como usar

O Plugin utiliza uma classe estática como “repositório” das configurações globais dele. Estas configurações ficam então acessíveis ao Behavior e Helper, garantindo funcionamento correto de ambos.

Classe AuditableConfig

É a classe que armazena as configurações do Plugin. Tem acesso estático aos seus quatro atributos, que são:

responsibleModel Uma string com o nome do Modelo que armazena os usuários do sistema;
responsibleId Um inteiro que representa o ID do usuário logado no sistema;
Logger A instância de um Modelo válido para salvar os logs;
serialize Uma string contendo o nome de uma função válida para serializar arrays;
unserialize Uma string contendo o nome de uma função válida para deserializar strings geradas pela função definida no atributo anterior.

No próximo item é sugerido uma forma de definir esses atributos para toda a aplicação.

Em todo lugar que precisar acessar esta classe (inclusive na hora de definir suas propriedades), faça a sua inclusão para garantir que esteja definida naquele escopo:

App::uses('AuditableConfig', 'Auditable.Lib');

Configuração mínima do Plugin

Existem duas configurações mínimas: a primeira é definir O Modelo que persistirá a mensagem
de log, a segunda é definir, logo que esteja disponível, a informação sobre o usuário logado.

Para a primeira, é preferível sobrecarregar o construtor do AppModel de maneira que a instância
do Modelo esteja pronta sempre que necessária. No seu AppModel faça algo como:

public function __construct($id = false, $table = null, $ds = null) {
	if(get_class($this) !== 'Logger' && empty(AuditableConfig::$Logger)) {
		// Caso deseje usar o modelo padrão, utilize como abaixo, caso contrário você pode usar qualquer modelo
		AuditableConfig::$Logger = ClassRegistry::init('Auditable.Logger', true);
	}

	parent::__construct($id, $table, $ds);
}

Para a informação do usuário logado, uma sugestão é usar o callback do AppController, deixando-o mais ou menos assim:

public function beforeFilter() {
	parent::beforeFilter();

	if($this->Auth->loggedIn()) {
		AuditableConfig::$responsibleId = $this->Auth->user('id');
	}
}

Em seguida você deve configurar em cada um dos modelos auditáveis o behavior Auditable, incluindo
ele em seu $actsAs da seguinte maneira

public $actsAs = array('Auditable.Auditable');

Behavior Auditable

É possível configurar alguns items do behavior, são eles:

auditSql : Opção para habilitar o log das queries geradas pelo CakePHP. O padrão é true.
skip : Lista (array) com nome dos campos que devem ser ignoradas no log.
fields : Aceita os dois índices abaixo
- created : Nome do campo presente em cada modelo para armazenar quem criou o registro
- modified : Nome do campo presente em cada modelo para armazenar quem alterou o registro

Helper Auditor

Suas configurações são:

formats : Um array com os diferentes formatos utilizados nos logs, conforme abaixo
- general : Uma string que será usada como descrição do log. Aceita dois placeholders: ‘:action’ e ‘:data’ que representam respectivamente a ação (criação ou modificação) e o que foi efetivamente alterado.
- prepend : Uma string que será prefixada em cada campo do log. Não aceita placeholders.
- pospend : Uma string que será pósfixada em cada campo do log. Não aceita placeholders.
- create : Uma string que será usado para logs de criação. Aceita os placeholders ‘:field’ e ‘:value’
- modify : Um string que será usada para logs de modificação. Aceita os placeholders ‘:field’, ‘:old’ e ‘:new’
- delete : Uma string que será usada para logs de remoção. Aceita os placeholders ‘:field’ e ‘:value’

Para usa-lo na view, basta invocar o método format

echo $this->Auditor->format($data['LogDetail']['difference'], $data['Logger']['type']);

Onde o primeiro parâmetro é a coluna ‘difference’ do modelo LogDetail e o segundo é o tipo de log (‘create’, ‘modify’, ‘delete’).

Autor e Copyright

Licença MIT – Isto quer dizer que o código está disponível sem nenhuma garantia, ao mesmo tempo que
você pode usa-lo de forma isolada ou em conjunto com seu próprio código.

Observações

Este behavior requer PHP versão >= 5.3
Compatível com CakePHP 2.x
Consulte o branch 1.3 para à versão com suporte ao CakePHP 1.3 e PHP >= 5.2
Consulte os testes incluído no plugin para ver melhor seu funcionamento

gildonei/auditable