PHP error_log

小咪咪 2023-09-30 09:44 12阅读 0赞

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

error\_log — 发送错误信息到某个地方

#### 说明 ####

**error\_log**(  
string `$message`,  
int `$message_type` = 0,  
string `$destination` = ?,  
string `$extra_headers` = ?  
): bool

把错误信息发送到 web 服务器的错误日志，或者到一个文件里。

#### 参数 ####

`message`

应该被记录的错误信息。

`message_type`

设置错误应该发送到何处。可能的信息类型有以下几个：

<table>  
 <strong><strong>error_log()</strong>&nbsp;日志类型</strong>  
 <tbody> 
  <tr> 
   <td>0</td> 
   <td><code>message</code>&nbsp;发送到 PHP 的系统日志，使用 操作系统的日志机制或者一个文件，取决于&nbsp;<a href="https://www.php.net/manual/zh/errorfunc.configuration.php#ini.error-log" title="error_log" rel="nofollow">error_log</a>&nbsp;指令设置了什么。 这是个默认的选项。</td> 
  </tr> 
  <tr> 
   <td>1</td> 
   <td><code>message</code>&nbsp;发送到参数&nbsp;<code>destination</code>&nbsp;设置的邮件地址。 第四个参数&nbsp;<code>extra_headers</code>&nbsp;只有在这个类型里才会被用到。</td> 
  </tr> 
  <tr> 
   <td>2</td> 
   <td>不再是一个选项。</td> 
  </tr> 
  <tr> 
   <td>3</td> 
   <td><code>message</code>&nbsp;被发送到位置为&nbsp;<code>destination</code>&nbsp;的文件里。 字符&nbsp;<code>message</code>&nbsp;不会默认被当做新的一行。</td> 
  </tr> 
  <tr> 
   <td>4</td> 
   <td><code>message</code>&nbsp;直接发送到 SAPI 的日志处理程序中。</td> 
  </tr> 
 </tbody> 
</table>

`destination`

目标。它的含义描述于以上，由 `message_type` 参数所决定。

`extra_headers`

额外的头。当 `message_type` 设置为 `1` 的时候使用。 该信息类型使用了 [mail()][mail] 的同一个内置函数。

#### 返回值 ####

成功时返回 **`true`**， 或者在失败时返回 **`false`**。

#### 注释 ####

**警告**

**error\_log()** 并非二进制安全的。null 字符可能截断 `message`。

**小技巧**

`message` 不能包含 null 字符。 注意，`message` 可能会发送到文件、邮件、syslog 等。 所以在调用 **error\_log()** 前需要使用适合的转换/转义函数： [base64\_encode()][base64_encode]、 [rawurlencode()][rawurlencode] 或 [addslashes()][addslashes]。

#### 范例 ####

**示例 \#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"); ?>`

![watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBAYWxsd2F5Mg_size_20_color_FFFFFF_t_70_g_se_x_16][]

[mail]: https://www.php.net/manual/zh/function.mail.php
[base64_encode]: https://www.php.net/manual/zh/function.base64-encode.php
[rawurlencode]: https://www.php.net/manual/zh/function.rawurlencode.php
[addslashes]: https://www.php.net/manual/zh/function.addslashes.php
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBAYWxsd2F5Mg_size_20_color_FFFFFF_t_70_g_se_x_16]: https://img-blog.csdnimg.cn/f366d548213c40359febdbbfc92bc646.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBAYWxsd2F5Mg==,size_20,color_FFFFFF,t_70,g_se,x_16