PHP日志怎么记录_error_log函数写入日志文件【详解】

你要用 error_log() 写文件，有几个坑是绕不开的。手动指定绝对路径、权限设置、换行符、还有并发安全——这些都得你自己处理。更麻烦的是，它既不支持日志轮转，也没有级别控制，很容易丢日志。说白了，与其硬刚这个原生函数，不如直接上 Monolog 或者框架自带的日志组件，省心得多。当然，如果你非得用，也得封装一下，至少用 file_put_contents() 加个文件锁。

直接用 error_log() 写文件，得手动指定路径和权限

error_log() 默认情况下并不会自己写文件，它会把日志丢给 SAPI——比如 Apache 的错误日志，或者命令行下的 stderr。想让日志落到自定义文件里，必须把第二个参数设成 3，表示“写入文件”，再通过第三个参数给出绝对路径：

error_log("User login failed", 3, "/var/log/myapp/error.log");

最常见的坑就是路径没写全。相对路径会按当前工作目录解析——命令行下可能是用户家目录，网页环境下通常是 Web 根目录或 PHP 进程的启动目录，结果很难预料。怎么解决？用绝对路径。

• 目标目录（比如 /var/log/myapp/）必须已经存在，而且 PHP 进程用户（例如 www-data 或 nginx）得有写权限
• 第一次写入时，文件不会自动创建父目录。你得提前用 mkdir -p /var/log/myapp 建好，再 chown www-data:www-data /var/log/myapp 把权限交出去
• 日志文件本身倒是不用预先创建，error_log() 会自己生成。但要是父目录没有写权限，它会静默失败——连个报错提示都没有

error_log() 不做日志轮转，也不加时间戳，得自己补

它只是原样往文件末尾追加字符串，不加换行、不加前缀、不格式化。看看这段代码：

error_log("User login failed", 3, $path);

实际写入的内容就是一行 User login failed，连个换行都没有。连续调用几次，所有内容就全挤在一行了。更关键的是，它不记录时间、不区分日志级别、也不支持附带上下文信息。真要拿它做生产日志，得自己手动拼接：

error_log(date('Y-m-d H:i:s') . " [ERROR] User login failed\n", 3, $path);

• 必须手动加上 \n，否则多条日志会粘在一起
• 时间格式建议用 date()，别用 microtime(true)——后者可读性差，时区还容易出问题
• 千万别指望 error_log() 会自动过滤敏感信息。密码、token 之类的数据得提前脱敏，它什么都不会帮你处理

并发写入时可能丢日志，error_log() 没锁机制

多个 PHP 进程（比如 FPM 的 worker）同时往同一个文件里写，内容截断、乱序甚至覆盖都是必然的。这可不是小概率事件——error_log() 底层调的是系统 write()，根本不会加文件锁。

• 流量小的时候可能还看不出来，一旦上了生产、QPS 上去，日志就会开始丢失
• 别想着“加个 sleep(0.001)”能缓解，治标不治本
• 真要简单省事的方案，改成 file_put_contents($path, $msg, FILE_APPEND | LOCK_EX)。它带 LOCK_EX，能保证原子写入（注意：PHP 5.6+ 才支持，而且 $path 所在的目录必须可写）

替代方案比硬刚 error_log() 更可靠

除非你只是在写一个极简的脚本，或者临时调试一下，否则真不建议把 error_log() 当作主力日志工具。它缺失的能力太多了：级别控制、格式化、处理器扩展、异步写入——这些统统没有。

• 轻量级方案：用 Monolog（Composer 包）。几行代码就能支持文件、Syslog、邮件等多种输出通道，时间戳和级别前缀自动加好
• 如果你已经在用 Lara vel，直接用 Log::error() 就行。底层封装了 RotatingFileHandler，每天自动切文件
• 实在没法换，至少封装一层：写一个 my_log_error($msg) 函数，统一处理时间、换行、路径、权限检查。别在业务代码里裸调 error_log()

真正麻烦的从来不是把日志写进去，而是写进去之后能不能顺利查到、会不会丢、要不要做轮转——这些都得自己扛，而 error_log() 一个都不管。