file_put_contents()是最简追加方案，但默认覆盖写入，需显式传FILE_APPEND标志；失败返回false须用===判断；权限、路径、编码、并发是四大关键风险点。
file_put_contents() 是最简方案，但要注意默认覆盖行为
PHP 写文件，file_put_contents() 是首选——它一行搞定打开、写入、关闭，比 fopen()+fwrite()+fclose() 组合更安全、更少出错。
但它默认是「覆盖写入」：哪怕文件存在且有内容，也会被清空重来。这在日志追加、配置更新等场景下极易翻车。
- 追加写入需显式传入
FILE_APPEND标志：file_put_contents('log.txt', "msg\n", FILE_APPEND) - 若还要确保换行符统一（尤其跨平台），建议手动加
\n，别依赖系统自动补 - 写入失败时函数返回
false，不是抛异常，必须用=== false判断，不能只用if (!$result)（空字符串也判为 false）
权限和路径错误是最常见的写入失败原因
写不进文件，90% 不是代码问题，而是运行环境拦住了你。
- 检查目标目录是否对 PHP 进程可写：
is_writable('/var/www/html/data/')要返回true；Web 服务器（如 www-data、nginx）用户必须有该目录的写权限 - 相对路径容易踩坑：脚本执行位置（
getcwd()）未必是你想的目录，建议用绝对路径，比如__DIR__ . '/data/config.json' - Windows 下注意反斜杠转义，或统一用正斜杠：
__DIR__ . '/logs/error.log'更可靠
大文件或高频写入时，fopen + fwrite 更可控
file_put_contents() 每次都重开文件，对大文件或循环内多次写入（比如导出 CSV）会明显拖慢性能，还可能触发磁盘 I/O 瓶颈。
立即学习“PHP免费学习笔记（深入）”；
- 先
$fp = fopen('big.csv', 'a');，循环中反复fwrite($fp, $line);，最后fclose($fp) - 写入前可用
flock($fp, LOCK_EX)加锁，避免并发写入导致数据错乱（多进程/多请求场景必需） - 记得设超时和错误处理：
if ($fp === false) { throw new RuntimeException('Cannot open file'); }
中文乱码？编码和 BOM 是隐形杀手
写入中文显示为问号或方块，大概率不是 PHP 问题，而是编码没对齐。
- 确保 PHP 文件本身保存为 UTF-8 无 BOM 格式（编辑器里可选，VS Code 默认带 BOM 的“UTF-8 with BOM”要避开）
- 写入前不强制转换编码，PHP 字符串就是字节流；但若源数据来自 GBK 接口，得先
mb_convert_encoding($str, 'UTF-8', 'GBK') - 写入 JSON 或 HTML 文件时，别忘了头部声明：
file_put_contents('data.json', "\xEF\xBB\xBF" . json_encode($data, JSON_UNESCAPED_UNICODE));（BOM 仅对部分旧编辑器/IE 有用，现代场景通常不需要）
file_put_contents() 静静失败，连错误提示都不给你。 
