在PHP项目开发中，日志记录是不可或缺的功能，它能帮助开发者追踪程序运行轨迹、定位异常问题、统计业务数据。不同的项目规模和需求对应不同的日志记录实现方案，下面介绍几种常用的PHP日志记录实现方式。
使用原生file_put_contents函数实现简单日志记录
对于小型项目或者临时日志记录需求，使用PHP原生的file_put_contents函数就能快速实现日志记录功能，这种方式不需要引入额外的依赖，实现逻辑简单。
下面是一个基础的日志记录函数示例：
<?php
/**
* 简单日志记录函数
* @param string $message 日志内容
* @param string $logFile 日志文件路径
* @return bool 是否写入成功
*/
function writeLog($message, $logFile = 'app.log') {
// 拼接日志前缀，包含时间和日志级别
$logPrefix = '[' . date('Y-m-d H:i:s') . '] [INFO] ';
// 拼接完整日志内容，添加换行符
$fullLog = $logPrefix . $message . PHP_EOL;
// 写入文件，使用FILE_APPEND避免覆盖原有内容，LOCK_EX防止并发写入冲突
return file_put_contents($logFile, $fullLog, FILE_APPEND | LOCK_EX);
}
// 调用示例
writeLog('用户登录成功，用户ID：1001');
writeLog('接口请求参数：{"page":1,"size":10}');
?>
这种方式的优点是轻量无依赖，缺点是功能比较单一，不支持日志分级、日志轮转等高级功能，适合简单的临时日志记录场景。
使用error_log函数记录日志
PHP内置的error_log函数也可以用来记录日志，它支持将日志输出到文件、系统日志或者指定邮箱，使用起来也比较方便。
下面是使用error_log记录日志的示例：
<?php
// 记录日志到指定文件
error_log('数据库查询异常：SQL语句执行失败', 3, 'error.log');
// 自定义日志格式，添加时间和级别
$logMessage = '[' . date('Y-m-d H:i:s') . '] [ERROR] 订单创建失败，订单号：20240501001' . PHP_EOL;
error_log($logMessage, 3, 'order_error.log');
?>
error_log函数的第二个参数用来指定日志发送方式，3表示发送到指定的文件路径，这种方式同样功能有限，适合简单的错误日志记录。
使用Monolog库实现专业日志记录
如果是中大型项目，推荐使用成熟的第三方日志库Monolog，它功能完善，支持日志分级、多通道输出、日志格式化、日志轮转等高级功能，是PHP生态中最常用的日志库。
首先需要通过Composer安装Monolog：
composer require monolog/monolog
下面是使用Monolog实现日志记录的完整示例：
<?php
require 'vendor/autoload.php';
use MonologLogger;
use MonologHandlerStreamHandler;
use MonologFormatterLineFormatter;
// 创建日志实例，设置日志名称
$log = new Logger('app');
// 创建文件处理器，设置日志级别为INFO，日志文件路径为app.log
$streamHandler = new StreamHandler('app.log', Logger::INFO);
// 自定义日志格式
$formatter = new LineFormatter(
"[%datetime%] [%level_name%] %message% %context% %extra%n",
"Y-m-d H:i:s"
);
$streamHandler->setFormatter($formatter);
// 添加处理器到日志实例
$log->pushHandler($streamHandler);
// 记录不同级别的日志
$log->info('用户注册成功', ['user_id' => 1002, 'username' => 'test_user']);
$log->warning('接口响应时间过长', ['url' => '/api/user/list', 'time' => 2.5]);
$log->error('支付回调验证失败', ['order_no' => '20240501002', 'error_msg' => '签名不匹配']);
?>
Monolog支持多种日志级别，从低到高分别是DEBUG、INFO、NOTICE、WARNING、ERROR、CRITICAL、ALERT、EMERGENCY，可以根据不同的场景选择对应的日志级别。同时它还支持将日志同时输出到多个通道，比如同时写入文件和发送到邮件，满足复杂的日志记录需求。
不同日志记录方案对比
下面通过表格对比几种常见的PHP日志记录方案的特点，方便开发者根据项目需求选择：
| 方案 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| file_put_contents | 无依赖、实现简单、轻量 | 功能单一、无日志分级、无轮转 | 小型项目、临时日志记录 |
| error_log | 原生内置、支持多输出方式 | 功能有限、格式自定义麻烦 | 简单错误日志记录 |
| Monolog | 功能完善、支持分级、轮转、多通道 | 需要引入第三方依赖 | 中大型项目、生产环境 |
日志记录注意事项
- 日志文件路径需要有写入权限，避免写入失败
- 生产环境不要记录过多DEBUG级别的日志，避免日志文件过大占用磁盘空间
- 敏感信息如用户密码、支付密钥等不要记录到日志中，防止信息泄露
- 高并发场景下建议使用异步日志记录，避免日志记录影响接口响应速度
PHP日志记录file_put_contentsmonologerror_log修改时间：2026-07-08 10:36:35