file_put_contents常写不进去因权限不足、目录不存在或磁盘满且静默失败；需确保目录存在并可写、加LOCK_EX防并发丢行、清理日志内容特殊字符、按天轮转防文件过大、优先用error_log或校验路径变量。
用 file_put_contents 记录访问日志，为什么常写不进去？
不是函数不能用，而是默认以 FILE_APPEND 模式追加时，如果文件权限不对、目录不存在或磁盘满，它会静默失败——不报错，也不写入。PHP 默认关闭了警告输出，你根本看不到 Warning: file_put_contents(...): failed to open stream 这类提示。
- 确保日志目录存在且 Web 用户（如
www-data或nginx）有写权限：mkdir -p /var/log/myapp+chown www-data:www-data /var/log/myapp - 别直接写绝对路径如
/var/log/myapp/access.log，先用is_writable()检查：if (!is_writable(dirname($log_path))) { error_log("Log dir not writable: " . dirname($log_path)); } - 避免在高并发下锁竞争：
file_put_contents默认不加锁，多请求同时写可能丢行。加LOCK_EX参数更稳妥：file_put_contents($log_path, $line, FILE_APPEND | LOCK_EX);
日志格式怎么拼才安全又可读？
直接拼接 $_SERVER['REMOTE_ADDR'] 或 $_SERVER['REQUEST_URI'] 有风险：URI 可能含换行、制表符甚至恶意控制字符，导致日志错行或解析混乱；IP 也可能被伪造（虽然不影响记录本身）。
- 用
str_replace清理换行和制表符：$uri = str_replace(["\n", "\r", "\t"], ' ', $_SERVER['REQUEST_URI']);
- 时间戳统一用
date('Y-m-d H:i:s')，别依赖microtime()—— 日志分析工具通常只认标准格式 - 推荐字段顺序：时间｜IP｜方法｜URI｜状态码｜UA（截断到 128 字）：
$line = date('Y-m-d H:i:s') . " | " . $_SERVER['REMOTE_ADDR'] . " | " . $_SERVER['REQUEST_METHOD'] . " | " . $uri . " | " . $http_code . " | " . mb_strimwidth($_SERVER['HTTP_USER_AGENT'] ?? '', 0, 128, '...') . "\n";
为什么日志文件越来越大，最后写不动了？
file_put_contents 不管文件大小，一直追加。几周后几百 MB 的单文件不仅难打开，还会拖慢写入速度（尤其是 NFS 或某些云存储卷），甚至触发系统级写入限制。
- 按天轮转最简单：把日志路径改成
/var/log/myapp/access_. date('Y-m-d') ..log，每天自动新建 - 不要自己删旧文件，用系统
logrotate更可靠（配置里加create 0644 www-data www-data） - 如果必须单文件，至少每写 10 万行就
fclose(fopen(..., 'a'))强制刷新缓冲区，避免内核缓存堆积
替代方案比 file_put_contents 更稳吗？
真要长期跑，file_put_contents 是够用的，但边界情况多。比如 PHP-FPM 子进程退出时未 flush 缓冲、Opcache 导致脚本提前终止、或者日志路径被符号链接指向不可写位置——这些都不会抛异常，只会“消失”。
立即学习“PHP免费学习笔记（深入）”；
- 生产环境建议用
error_log($msg, 3, $path)：底层调用更轻量，且自动处理部分权限/路径问题 - 想结构化？直接写 JSON 行（每行一个 JSON 对象），但注意
json_encode要加JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES，否则日志体积翻倍 - 别忘了设置
open_basedir允许写入日志目录，否则即使权限对也会被 PHP 主动拦截
最常被忽略的是：日志路径里的变量没做初始化检查。比如 $log_path = $_ENV['LOG_DIR'] ?? '/tmp' . '/access.log'，万一 $_ENV['LOG_DIR'] 是空字符串，就会写到根目录下——而多数服务器禁止 Web 进程往 / 写文件。
