使用 file_put_contents 和 error_log 可实现 php cli 脚本的日志记录，推荐封装函数并加锁防冲突，注意路径权限与敏感信息保护，生产环境宜用 monolog。
在使用PHP进行命令行脚本开发时，日志记录是排查问题、监控运行状态的重要手段。虽然CLI模式下没有浏览器输出的直观性，但通过简单的文件写入或系统日志方式，可以高效实现信息追踪。
使用 file_put_contents 写入日志文件
最直接的日志记录方法是将信息写入本地文件。PHP 的 file_put_contents 函数支持追加模式，非常适合记录命令行脚本的执行日志。
示例代码：
$logMessage = date('Y-m-d H:i:s') . ' - 执行了某个操作' . PHP_EOL;
file_put_contents('/tmp/script.log', $logMessage, FILE_APPEND);
说明：
- FILE_APPEND 标志确保每次写入不会覆盖原有内容
- 使用 PHP_EOL 保证换行符跨平台兼容
- 日志路径建议使用绝对路径，避免因工作目录不同导致写入失败
封装简单的日志函数
为了提高复用性，可封装一个通用的日志记录函数。
function logMessage($message, $logFile = '/tmp/php_script.log') {
$entry = sprintf("[%s] %s%s", date('Y-m-d H:i:s'), $message, PHP_EOL);
file_put_contents($logFile, $entry, FILE_APPEND | LOCK_EX);
}
// 使用示例
logMessage('脚本开始执行');
logMessage('处理完成，共耗时 2.5 秒');
注意：
- 加入 LOCK_EX 参数防止多进程写入冲突
- 可根据需要扩展日志级别（info、error 等）
- 建议对日志目录存在性做判断，避免写入失败
利用 error_log 写入系统日志
PHP 的 error_log 不仅可用于错误记录，在CLI下也能定向输出到指定文件。
立即学习“PHP免费学习笔记（深入）”；
error_log("用户导入任务启动\n", 3, "/var/log/myapp.log");
其中第二个参数为消息类型：
- 3 表示追加到指定文件
这种方式更轻量，且能结合系统日志机制统一管理。
注意事项与最佳实践
实际使用中需关注以下几点：
- 确保日志目录有写权限，可通过 is_writable() 提前检查
- 敏感信息如密码、密钥不应记录在日志中
- 定期清理旧日志，避免磁盘占满
- 生产环境建议使用 monolog 等专业库，支持更多处理器和格式化功能
基本上就这些。对于大多数命令行脚本，简单的文件追加写入已足够满足调试和监控需求，关键是保持格式统一、路径明确、内容清晰。
