PHP写日志最直接方式是fopen(‘a’) + fwrite，需注意追加模式、时间戳、fclose及文件权限；更安全推荐error_log($msg, 3, $file)，它自动处理锁和句柄；高并发下须加flock或改用异步；路径、级别、格式应配置化并支持轮转。
PHP 写日志最直接的方式是 fopen + fwrite
不用框架、不依赖扩展时，手动写日志文件就是最可控的方案。核心逻辑是：以追加模式打开文件，写入带时间戳的格式化内容，最后关闭句柄。
-
fopen($file, 'a')必须用'a'模式（追加），否则会覆盖已有日志 - 每次写入前建议调用
date('Y-m-d H:i:s')记录精确时间点 - 写完必须
fclose($fp)，否则在高并发下可能丢失日志或损坏文件 - 注意文件路径权限：Web 进程用户（如
www-data或nginx）必须有写权限
function log_to_file($message, $file = '/var/log/myapp.log') {
$fp = fopen($file, 'a');
if ($fp) {
$line = sprintf("[%s] %s/n", date('Y-m-d H:i:s'), $message);
fwrite($fp, $line);
fclose($fp);
}
}
用 error_log() 写文件比手写更安全
PHP 内置的 error_log() 函数支持直接写文件，它自动处理文件锁和并发写入问题，比裸 fwrite 更健壮。
- 第三个参数设为
3表示写入文件（不是系统日志或 stderr） - 第二个参数传文件路径，PHP 会自动创建文件（但不会创建目录）
- 不会因忘记
fclose导致句柄泄漏 - 注意：如果路径目录不存在，会报
Warning: error_log(): Failed to open stream
error_log("User login failed: uid=123", 3, "/var/log/myapp.log");
多进程/高并发下必须考虑日志文件锁
多个 PHP 进程同时写同一个日志文件，即使用了 'a' 模式，仍可能出现内容错行、截断或覆盖——因为 fwrite 不是原子操作。
- 简单方案：用
flock($fp, LOCK_EX)加写锁，写完再LOCK_UN - 更推荐：用
error_log()，它内部已做 flock 处理 - 极端场景（如每秒数百次写入）：考虑异步写入（如通过消息队列转发到独立日志进程）
- 别用
file_put_contents($file, $msg, FILE_APPEND)替代，它不保证线程安全
生产环境别硬编码日志路径和格式
路径写死在代码里会导致迁移困难；纯文本日志难排查；没分级（debug/info/warn/error）会让关键错误被淹没。
立即学习“PHP免费学习笔记（深入）”；
- 把日志路径抽成配置项，例如从
$_ENV['LOG_PATH']或配置文件读取 - 至少区分级别：在每条日志前加
[ERROR]、[INFO]等标记 - 考虑 JSON 格式输出（方便后续用 ELK 或 Loki 解析）：
json_encode(['level'=>'error', 'time'=>date('c'), 'msg'=>$msg]) - 定期轮转日志：PHP 不内置轮转，可用
logrotate配合，或用 Monolog 等库
日志看似简单，真正卡住人的往往是并发写入、路径权限、格式统一和长期维护——这些细节比“怎么写第一行”重要得多。