Download the PHP package radig/auditable without Composer

h1. CakePHP Auditable !https://travis-ci.org/radig/auditable.png?branch=master(Build Status)!:https://travis-ci.org/radig/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.

h2. 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.

h3. 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:

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

h3. 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

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

h3. 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

h3. 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

bc. 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').

h2. Autor e Copyright

• Copyright 2011-2013, "Radig - Soluções em TI":http://www.radig.com.br
• 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.

h2. 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