PHP日志文件名应通过date()动态生成,但必须先用date_default_timezone_set()设时区,复用文件指针避免频繁打开关闭,且需检查fwrite返回值防丢日志。

PHP日志文件名如何用日期动态生成
直接用 date() 拼接路径最简单,但必须注意时区和格式一致性。默认时区不设会导致日志写到“昨天”或“明天”的文件里,尤其部署在 Docker 或跨时区服务器时极易出错。
推荐写法:
$logDir = '/var/log/myapp';
$dateStr = date('Y-m-d'); // 不带时区参数时,依赖 date_default_timezone_set()
$fileName = "{$logDir}/app-{$dateStr}.log";
- 务必在脚本开头调用
date_default_timezone_set('Asia/Shanghai')(按实际业务时区选) - 避免用
strftime()—— 它受系统 locale 影响,同一份代码在不同服务器可能产出不同格式 - 目录
$logDir必须提前存在且 PHP 进程有写权限,否则fopen()会静默失败或报Warning: failed to open stream
每次写日志前都检查并创建新文件是否必要
不是每次都要检查。频繁调用 file_exists() + mkdir() + touch() 会拖慢高并发写入。更合理的方式是:只在文件名变更时切换句柄,其余时间复用已打开的 $fp。
关键逻辑是缓存当前日期字符串和文件指针:
立即学习“PHP免费学习笔记(深入)”;
$currentDate = null;
$fp = null;
<p>function writeLog($msg) {
global $currentDate, $fp;
$today = date('Y-m-d');
if ($today !== $currentDate) {
if ($fp) fclose($fp);
$fileName = "/var/log/app-{$today}.log";
$fp = fopen($fileName, 'a');
$currentDate = $today;
}
fwrite($fp, date('Y-m-d H:i:s') . " {$msg}\n");
}
- 不要在
fopen()前加is_writable()判断——它本身就有权限检查,多一次 syscall 是纯开销 - 如果进程长期运行(如 CLI 守护进程),需考虑
fclose()失败时的兜底,比如记录到/dev/stderr避免丢日志 - 注意
fopen(..., 'a')在文件不存在时会自动创建,无需提前touch()
用 error_log() 能否实现按日期分文件
不能直接实现。PHP 的 error_log() 默认写入 Apache/Nginx 错误日志或系统 syslog,即使指定文件路径,也无法在写入时动态替换日期占位符。
- 传入字符串路径(如
error_log($msg, 3, '/var/log/app-' . date('Y-m-d') . '.log'))看似可行,但date()在调用时计算,无法保证同一天内所有日志都进同一个文件——因为每次调用都重新生成文件名,跨秒就可能切到新文件 - 想用
error_log()又要分日期,只能封装一层:自己维护一个当日文件句柄,再把日志转给fwrite() - 更现实的做法是弃用
error_log(),改用file_put_contents($fileName, $msg . "\n", FILE_APPEND | FILE_LOCK),但要注意FILE_LOCK在 NFS 或某些容器挂载卷上可能失效
线上环境要注意的三个硬性限制
开发机跑通不等于线上能用。以下三点不处理,日志会悄无声息丢失或错乱:
- Linux 文件描述符限制:
ulimit -n默认常为 1024,如果每秒新建文件句柄又不关,很快耗尽,导致后续fopen()返回false—— 必须复用句柄,而不是“每次写都 fopen + fclose” - SELinux 或 AppArmor 策略可能禁止 PHP 进程向
/var/log写入,错误信息藏在ausearch -m avc -ts recent里,不会出现在 PHP 错误中 - 日志目录磁盘满时,
fwrite()不报错但返回0,需检查返回值:if (fwrite($fp, $line) === false) { /* 备用输出通道 */ }
日期变量容易被当成常量来用,但它的本质是运行时快照;真正难的是让这个快照在整秒、整分、整小时边界上稳定切换,而不是靠运气。



















