Php/docs/function.error-log
error_log
(PHP 4, PHP 5, PHP 7)
error_log — 发送错误信息到某个地方
说明
error_log
( string $message
[, int $message_type
= 0
[, string $destination
[, string $extra_headers
]]] ) : bool
把错误信息发送到 web 服务器的错误日志,或者到一个文件里。
参数
message
应该被记录的错误信息。
message_type
设置错误应该发送到何处。可能的信息类型有以下几个:
error_log() 日志类型 0 message
发送到 PHP 的系统日志,使用操作系统的日志机制或者一个文件,取决于 error_log 指令设置了什么。 这是个默认的选项。
1 message
发送到参数destination
设置的邮件地址。 第四个参数
extra_headers
只有在这个类型里才会被用到。2 不再是一个选项。 3 message
被发送到位置为destination
的文件里。字符
message
不会默认被当做新的一行。4 message
直接发送到 SAPI 的日志处理程序中。destination
目标。它的含义描述于以上,由
message_type
参数所决定。extra_headers
额外的头。当
message_type
设置为1
的时候使用。 该信息类型使用了 mail() 的同一个内置函数。
返回值
成功时返回 true
, 或者在失败时返回 false
。
注释
Warning
error_log() 并非二进制安全的。null 字符可能截断 message
。
Tip
message
不能包含 null 字符。
注意,message
可能会发送到文件、邮件、syslog 等。
所以在调用 error_log() 前需要使用适合的转换/转义函数: base64_encode()、 rawurlencode() 或 addslashes()。
范例
Example #1 error_log() 范例
<?php// 如果无法连接到数据库,发送通知到服务器日志if (!Ora_Logon($username, $password)) { error_log("Oracle database not available!", 0);}// 如果用尽了 FOO,通过邮件通知管理员if (!($foo = allocate_new_foo())) { error_log("Big trouble, we're all out of FOOs!", 1, "operator@example.com");}// 调用 error_log() 的另一种方式:error_log("You messed up!", 3, "/var/tmp/my-errors.log");?>
更新日志
版本 | 说明 |
---|---|
5.2.7 | 可能的值:4添加到了 message_type 。
|