error_log
(PHP 4, PHP 5, PHP 7, PHP 8)
error_log — Надсилає повідомлення про помилку заданому обробнику помилок
Опис
error_log( string $message, int $message_type = 0, ?string $destination = null, ?string $additional_headers = null): bool
Надсилає повідомлення про помилку в лог веб-сервера або в файл користувача.
Список параметрів
message
Повідомлення про помилку, яка має бути логована.
message_type
Визначає, куди відправляти помилку. Можливі такі значення:
| 0 | Повідомлення message відправляється в системний реєстратор PHP, використовуючи механізм логування операційної системи, або файл, залежно від значення директиви error_log у конфігураційному файлі. Це значення за промовчанням. |
| 1 | Повідомлення message надсилається електронною поштою на адресу, встановлену у параметрі destination. Це єдиний тип повідомлення, де використовується четвертий параметр additional_headers. |
| 2 | Більше не використовується.< /td> |
| 3 | message застосовується до зазначеного в destination файлу. Перенесення рядка автоматично не додається до кінця message. |
| 4 | Повідомлення message відправляється безпосередньо в обробник логера SAPI. |
destination
Назначение. Устанавливается в зависимости от параметраmessage_type
additional_headers
Додаткові заголовки. Використовується, коли значення параметра message_type . Цей тип повідомлення використовує ту саму внутрішню функцію, що й mail()
Значення, що повертаються
Повертає true у разі успішного виконання або **false**в случае возникновения ошибки. Еслиmessage_type дорівнює нулю, функція завжди повертає **true**незалежно від того, чи може помилка логуватися чи ні.
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | Параметрdestinationиadditional_headers тепер допускають значення null. |
Приклади
Приклад #1 Приклади використання error_log()
Примітки
Увага
error_log() не є бінарно-безпечною функцією . message обрізається за null-символом.
Підказка
message ні містити null-символ. Врахуйте, що message може передаватися у файл, поштою, syslog і т.д. Використовуйте відповідну перетворювальну або екрануючу функцію, base64_encode() rawurlencode() або addslashes() перед викликом error_log()