openlog

(PHP 4, PHP 5, PHP 7, PHP 8)

openlogОткрывает соединение к системному журналу

Описание

openlog(string$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() - Закрывает соединение с системным журналом
To Top