PHP日志需主动配置或调用,最轻量方式是error_log()函数写入指定文件;也可通过php.ini全局配置记录错误;推荐封装log_msg()函数统一格式;大型项目宜用Monolog等专业库。

PHP 文件本身不会自动生成日志,必须主动调用日志记录函数或配置日志机制。最常用、最轻量的方式是使用 error_log() 函数,它能快速把信息写入系统日志、Web 服务器错误日志,或指定文件。
用 error_log() 写入自定义日志文件
这是开发中最灵活的方法:直接指定日志路径,无需额外扩展。
- 基本写法:
error_log("用户登录失败", 3, "/var/log/myapp.log"); - 参数说明:第1个是日志内容,第2个是类型(3 表示写入文件),第3个是目标文件路径
- 注意确保 PHP 进程对目标目录有写权限,否则日志会静默失败
- 建议配合日期格式化,方便归档:
error_log(date('Y-m-d H:i:s') . " [INFO] 请求完成\n", 3, "/var/log/app.log");
利用 PHP 内置的 error_log 配置(全局方式)
适合统一管理所有错误和警告,不需每处都写日志语句。
- 在
php.ini中设置:error_log = /var/log/php_errors.log - 同时开启错误报告:
error_reporting = E_ALL和log_errors = On - 重启 Web 服务(如 Apache 或 PHP-FPM)后生效
- 该方式只记录 PHP 错误/警告/通知,不记录业务逻辑日志(如“订单创建成功”)
简单封装一个日志工具函数(推荐开发中使用)
避免重复写路径和格式,提升可维护性。
立即学习“PHP免费学习笔记(深入)”;
- 在项目入口或公共文件中定义:
function log_msg($msg, $level = 'INFO') {
$time = date('Y-m-d H:i:s');
$log_line = "[$time] [$level] $msg" . PHP_EOL;
error_log($log_line, 3, '/var/log/myapp.log');
}- 调用示例:
log_msg("用户ID=123访问了订单页", "ACCESS"); - 可进一步支持多级别(DEBUG/INFO/WARN/ERROR)和自动分文件
进阶选择:用 Monolog 等专业日志库
当项目变大、需要滚动日志、多通道(文件+邮件+Slack)、结构化输出时,建议引入。
- 通过 Composer 安装:
composer require monolog/monolog - 支持按大小/时间自动切割日志、异步写入、上下文变量注入等
- 学习成本略高,但长期看更稳定、易扩展
- 小项目或临时调试不建议一开始就上,容易过度设计
不复杂但容易忽略:日志路径要绝对路径,权限要检查,生产环境别用 var_dump() 或 print_r() 替代日志,它们不会持久保存,也难排查。











