openlog
(PHP 4, PHP 5, PHP 7)
openlog — Открывает соединение к системному журналу
Описание
$prefix
, int $flags
, int $facility
) : boolФункция openlog() открывает соединение к системному журналу для программы.
Использование openlog() не является обязательным. Эта функция при необходимости будет вызвана функцией syslog() автоматически, при этом параметр prefix будет по умолчанию равен false.
Список параметров
-
prefix -
Строка
prefixдобавляется к каждому сообщению. -
flags -
Аргумент
flagsиспользуется для указания используемых опций журналирования при создании записи журнала.
Можно использовать одну или сразу несколько опций. При использовании нескольких опций необходимо разделять ихОпции openlog() Константа Описание LOG_CONSесли при отправке данных системному журналу происходит ошибка, перевести вывод непосредственно в системную консоль LOG_NDELAYоткрыть соединение с журналом без задержки LOG_ODELAY(по умолчанию) отложить открытие соединения до вывода первого сообщения в журнал LOG_PERRORвыводить вместе со стандартной ошибкой сообщение журнала LOG_PIDдобавить PID к каждому сообщению OR, к примеру, для открытия соединения без задержки, записи в консоль и включения PID в каждое из сообщений, необходима следующая комбинация опций:LOG_CONS | LOG_NDELAY | LOG_PID -
facility -
Параметр
facilityиспользуется для определения типа программы, создавшей сообщение журнала. Это позволяет определить (в конфигурации syslog) как будут обработаны сообщения журнала, поступающие из разных объектов.Типы программ openlog() Константа Описание LOG_AUTHсообщения по безопасности/авторизации (необходимо взамен использовать LOG_AUTHPRIVв системах, где эта константа предопределена)LOG_AUTHPRIVсообщения по безопасности/авторизации (частное) LOG_CRONпланировщик задач (cron и at) LOG_DAEMONдругие системные службы LOG_KERNсообщения ядра LOG_LOCAL0...LOG_LOCAL7зарезервированы для локального использования, недоступны в Windows LOG_LPRподсистема печати LPR LOG_MAILпочтовая подсистема LOG_NEWSподсистема новостей USENET LOG_SYSLOGвнутренние сообщения syslogd LOG_USERобщие сообщения на уровне пользователя LOG_UUCPподсистема UUCP Замечание:
LOG_USER- единственный верный тип журналирования в операционных системах Windows
Возвращаемые значения
Возвращает true в случае успешного завершения или false в случае возникновения ошибки.
Смотрите также
- syslog() - Генерирует сообщение для системного журнала
- closelog() - Закрывает соединение с системным журналом