magento
Вход в файл
Поиск…
Синтаксис
- публичный статический журнал функций ($ message, $ level = null, $ file = '', $ forceLog = false)
параметры
параметр | подробности |
---|---|
string $ message | Сообщение, которое будет зарегистрировано |
целочисленный $ level | Уровень журнала |
string $ file | Путь и имя с расширением файла, который будет сохранен в var/log/ . Если NULL или не указано, будет использоваться system.log . |
bool $ forceLog | Если установлен в TRUE журнал, будет записан, даже если режим разработчика выключен, и регистрация неактивна. |
замечания
Ведение журнала отключено по умолчанию, если только режим разработчика не активен.
Все исключения регистрируются в exceptions.log
независимо от того, включено ли ведение журнала в конфигурации.
Ведение журнала можно включить, войдя в Magento Admin и перейдите к:
- Система> Конфигурация (верхняя панель)
- Разработчик (левое меню)
- Раздел «Настройки журнала»
- Выберите Да из раскрывающегося списка «
Enabled
. - Сохраните конфигурацию в правом верхнем углу.
Тип переменной сообщения
Хотя документация определяет, что сообщение должно быть строкой, если массив передан, в этом методе есть блок кода, чтобы позаботиться об этом с помощью print_r
:
if (is_array($message) || is_object($message)) {
$message = print_r($message, true);
}
Уровень журнала
Если для параметра уровня установлено значение null, то берется уровень DEBUG.
$level = is_null($level) ? Zend_Log::DEBUG : $level;
Уровни объявлены в файле: lib\Zend\log.php
const EMERG = 0; // Emergency: system is unusable
const ALERT = 1; // Alert: action must be taken immediately
const CRIT = 2; // Critical: critical conditions
const ERR = 3; // Error: error conditions
const WARN = 4; // Warning: warning conditions
const NOTICE = 5; // Notice: normal but significant condition
const INFO = 6; // Informational: informational messages
const DEBUG = 7; // Debug: debug messages
Константы в виде Zend_Log::INFO
или целочисленного числа в указанном выше диапазоне могут быть переданы как параметр уровня журнала.
Пользовательский файл журнала
Mage::log('My log entry', null, 'mylogfile.log');
Этот wil log to
/var/log/mylogfile.log
Регистрация по умолчанию
Mage::log('My log entry');
Mage::log('My log message: '.$myVariable);
Mage::log($myArray);
Mage::log($myObject);
Это приведет к регистрации /var/log/system.log
Объекты и массивы автоматически записываются с помощью директивы print_r()
. Остерегайтесь использования объектов, поскольку они могут иметь существенный размер.
Mage::logException($e);
Это приведет к записи строки трассировки исключения в /var/log/exception.log