openlog
(PHP 4, PHP 5)
openlog — Открывает соединение к системному журналу
Описание
bool openlog
( string $ident
, int $option
, int $facility
)
Использование openlog() не является обязательным. Эта функция при необходимости будет вызвана функцией syslog() автоматически, при этом параметр ident будет по умолчанию равен FALSE.
Список параметров
-
ident
-
Строка ident добавляется к каждому сообщению.
-
option
-
Аргумент option используется для указания используемых опций журналирования при создании записи журнала.
Опции openlog()
Constant |
Description |
LOG_CONS |
если при отправке данных системному журналу происходит ошибка, перевести вывод непосредственно в системную консоль
|
LOG_NDELAY |
открыть соединение с журналом без задержки
|
LOG_ODELAY |
(по умолчанию) отложить открытие соединения до вывода первого сообщения в журнал
|
LOG_PERROR |
выводить вместе со стандартной ошибкой сообщение журнала |
LOG_PID |
добавить PID к каждому сообщению |
Можно использовать одну или сразу несколько опций. При использовании нескольких опций необходимо разделять их OR, к примеру, для открытия соединения без задержки, записи в консоль и включения PID в каждое из сообщений, необходима следующая комбинация опций: LOG_CONS | LOG_NDELAY | LOG_PID
-
facility
-
Параметр facility используется для определения типа программы создавшей сообщение журнала. Это позволяет определить (в конфигурации syslog) как будут обработаны сообщения журнала, поступающие из разных объектов.
openlog() Facilities
Константа |
Описание |
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() - Generate a system log message
- closelog() - Завершает соединение с системным журналом