This document is for a version of CakePHP that is no longer supported. Please upgrade to a newer release!

Page Contents

Log

Por mais que as configurações da classe Configure do CakePHP possam realmente ajudar você a visualizar o que está acontecendo por dentro de sua aplicação, algumas vezes é importante ter logs de dados no disco para descobrir o que está acontecendo. Num mundo que está se tornando cada vez mais dependente de tecnologias como SOAP e AJAX, a depuração pode ser bem dificultada.

Log de erros também pode ser uma maneira de visualizar o que acontece com sua aplicação ao longo do tempo. Que termos de busca estão sendo usados? Que tipos de erros estão sendo mostrados a meus usuários? Quão frequente executada é uma determinada consulta?

Fazer log de dados no CakePHP é fácil - a função the log() é parte da classe Object, que é o ancestrarl comum para a maioria das classes do CakePHP. Se o contexto for uma classe do CakePHP (Models, Controllers, Components… praticamente tudo), você pode registrar um log dos dados.

Usando a função log

A função log() leva dois parâmetros. O primeiro é a mensagem que você gostaria de escrever no arquivo de log. Por padrão, esta mensagem de erro é escrita para o arquivo log de erro encontrado em app/tmp/logs/error.log.

// Executar isto dentro de uma classe CakePHP...

$this->log("Alguma coisa não deu certo!");

// ...resulta nisto sendo anexado ao arquivo app/tmp/logs/error.log

2007-11-02 10:22:02 Error: Alguma coisa não deu certo!

O segundo parâmetro é usado para definir o tipo do log de erro cuja mensagem você quer escrever. Se não informado, o padrão para este segundo parâmetro é LOG_ERROR, que registra o log de erro previamente mencionado. Você pode definir este segundo parâmetro, p.ex., para LOG_DEBUG para escrever suas mensagem para um arquivo de log alternativo de depuração que será encontrado em app/tmp/logs/debug.log:

// Executar isto dentro de uma classe CakePHP...

$this->log('Uma mensagem de depuração.', LOG_DEBUG);

// ...resulta nisto sendo anexado ao arquivo app/tmp/logs/debug.log (ao invés de error.log)

2007-11-02 10:22:02 Error: Uma mensagem de depuração.

Você também pode especificar um nome diferente para o arquivo de log definindo um nome de arquivo como segundo parâmetro.

// Executar isto dentro de uma classe CakePHP...

$this->log('Uma mensagem especial do registro de log da atividade.', 'activity');

// ...resulta nisto sendo anexado ao arquivo app/tmp/logs/activity.log (ao invés de error.log)

2007-11-02 10:22:02 Activity: Uma mensagem especial do registro de log da atividade.

Seu diretório app/tmp deve ter permissão de escrita para o usuário do servidor web para que os recursos de log funcionem corretamente.