PHP error_log() 函数

实例

把错误消息发送到 web 服务器日志和邮件账号:

<?php
// 如果错误连接至数据库,则向服务器日志发送错误消息
if (!mysqli_connect("localhost","bad_user","bad_password","my_db")) {
    error_log("Failed to connect to database!", 0);
}

// 如果用完 FOO,向管理员发送电邮
if (!($foo = allocate_new_foo())) {
    error_log("Oh no! We are out of FOOs!", 1, "admin@example.com");
}
?> 

定义和用法

error_log() 函数向服务器错误记录、文件或远程目标发送错误消息。

语法

error_log(message,type,destination,headers);
参数 描述
message 必需。规定要记录的错误消息。
type

可选。规定错误应该发送到何处。可能的值:

  • 0 - 默认。消息被发送到 PHP 的系统日志,使用操作系统的日志机制或者一个文件,取决于 php.ini 中如何 error_log 指令。
  • 1 - 消息被发送到参数 destination 设置的邮件地址。第四个参数 extra_headers 只有在这个类型里才会被用到。
  • 2 - 不再使用(仅用在 PHP 3 中)
  • 3 - 消息被发送到位置为 destination 的文件里。字符 message 不会默认被当做新的一行。
  • 4 - 消息被直接发送到 SAPI 日志处理程序中。
destination 可选。规定错误消息的目标。该值由 type 参数的值决定。
headers

可选。规定额外的头,比如 From、Cc 和 Bcc。该信息类型使用了 mail() 的同一个内置函数。

仅当 message_type 设置为 1 的时候使用。

应当使用 CRLF (\r\n) 来分隔多个头。

技术细节

返回值: 若成功则返回 TRUE,失败则返回 FALSE。
PHP 版本: 4.0+
PHP 更新日志: PHP 5.2.7:可能的值:4 添加到了 type 参数。