file_put_contents写入失败主因是路径不存在、权限不足、编码问题及未处理返回值；需手动创建父目录、加LOCK_EX保证并发安全、清除BOM并统一UTF-8编码，高频率场景应改用fopen。
file_put_contents 看似一行搞定，但 PHP 7.4 下写入失败、乱码、并发错乱、目录不存在却静默返回 false——这些问题基本都出在「没管路径、没设标志、没验返回、没清 BOM」这四点上。
路径不存在时为什么没报错，只是返回 false？
因为 file_put_contents 默认不创建父目录，dirname($path) 对应的路径若不存在，函数直接失败并返回 false，不会抛异常也不会提示。
- 用
is_dir(dirname($path))提前判断，再配合mkdir(dirname($path), 0755, true)递归创建（true是关键） - Windows 下路径分隔符用
/更稳妥，避免\被当转义符（如C:/logs/app.log） - 相对路径基于
getcwd()，不是脚本所在目录；建议统一用__DIR__ . '/data/output.txt'拼绝对路径
追加写日志时内容错位或丢失，该加哪些 flags？
单纯传 FILE_APPEND 不够——并发写入时多个进程可能同时打开文件，导致内容交叉覆盖。
- 必须组合
FILE_APPEND | LOCK_EX，LOCK_EX保证写入原子性 - PHP 7.4+ 支持
FILE_TEXT，加上它可禁用二进制模式，避免某些系统下换行符被误处理 - 别依赖自动换行：显式在
$data末尾加"\n"，否则多条日志会挤成一行 - 返回值必须用
=== false判断，因为写入 0 字节也返回0，和false类型不同
写中文变乱码或 JSON 解析失败，怎么清 BOM 和统一编码？
记事本乱码常因编辑器默认 GBK 解码 UTF-8 内容；JSON 失败则大概率是文件开头混入了 \xEF\xBB\xBF（UTF-8 BOM）。
立即学习“PHP免费学习笔记（深入）”；
- 写入前用
mb_convert_encoding($content, 'UTF-8', 'auto')自动识别源编码并转 UTF-8 - 坚决不用
utf8_encode()——它只对 ISO-8859-1 有效，对 GBK/GB2312 会出错 - 清除 BOM：
ltrim($content, "\xEF\xBB\xBF")，放在file_put_contents前一步 - 若写配置文件（如
config.php），用var_export($arr, true)替代serialize()，更易读且无编码陷阱
数组写入文件，选 serialize/json/var_export 有什么区别？
三者适用场景完全不同，选错会导致读取失败或安全风险。
-
serialize()：保留完整类型（含资源、对象），但只能用unserialize()读，且反序列化有 RCE 风险，**绝不用于不可信数据** -
json_encode($arr, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT)：跨语言、安全、人可读，但丢弃资源/资源句柄/闭包，适合 API 日志或前端通信 -
var_export($arr, true)：输出合法 PHP 语法，写入后可直接include，适合配置文件，但注意不要写入用户输入内容（执行风险） - 多维数组不能直接传给
file_put_contents，会转成字符串Array，必须先序列化或编码
最易被忽略的是：file_put_contents 在高频率写入（比如每秒多次）时性能急剧下降——每次调用都重开文件句柄。真要高频写，得换成 fopen + fwrite + fflush 复用句柄，而不是硬扛 file_put_contents。
