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() - Закриває з'єднання із системним журналом