PHP写入文件需检查fwrite()返回值而非仅fopen()，file_put_contents()更简洁但需确保目录存在，关键场景应读回校验内容，并排查权限与SELinux等底层限制。
用 fopen() 创建文件并判断写入是否成功
PHP 中最常用也最直接的方式是用 fopen() 打开文件（自动创建）再配合 fwrite() 写入，最后检查返回值。关键不是“文件是否存在”，而是“写操作是否真正落盘”。
常见错误是只检查 fopen() 是否返回资源，却忽略 fwrite() 可能返回 false（比如磁盘满、权限不足但文件已创建）。
-
fopen($path, 'w')在路径不可写时直接返回false；但如果父目录可写、文件名非法（如含/../），可能静默失败或创建错位文件 - 务必检查
fwrite()返回值：它返回实际写入字节数，写入 0 字节不等于失败，但返回false一定失败 - 写完建议调用
fflush($fp)+fclose($fp)，避免缓冲未刷导致误判“写入成功”
if ($fp = fopen('/tmp/test.txt', 'w')) {
$written = fwrite($fp, 'hello');
fflush($fp);
fclose($fp);
if ($written === false) {
echo '写入失败';
} else {
echo '写入成功，写了 ' . $written . ' 字节';
}
} else {
echo '无法打开/创建文件';
}
用 file_put_contents() 一行判成败
比手动管理文件指针更简洁，file_put_contents() 默认会创建文件、覆盖写入，并直接返回写入字节数或 false。它是原子操作，适合简单场景。
注意：它默认不创建不存在的目录，如果 /logs/app/ 不存在，file_put_contents('/logs/app/log.txt', ...) 会失败 —— 这点常被忽略。
立即学习“PHP免费学习笔记（深入）”；
- 加
FILE_USE_INCLUDE_PATH不解决路径问题；真正需要的是提前用mkdir(..., 0755, true)确保目录存在 - 若需追加写入，用
FILE_APPEND标志，但要注意并发下可能错行（无锁） - 写入空字符串
''会清空文件，返回0，这不是错误，别当成失败处理
$res = file_put_contents('/tmp/test.txt', 'data');
if ($res === false) {
echo '写入失败：' . error_get_last()['message'];
} else {
echo '成功写入 ' . $res . ' 字节';
}
写入后用 file_get_contents() 反查验证
某些关键场景（如配置生成、密钥保存），不能只信函数返回值，得读回来比对内容。因为：NFS 挂载延迟、SELinux 上下文限制、或挂载为 noexec,nodev 时，可能允许创建但禁止后续读取。
- 先写，再
file_get_contents()，再md5()或strcmp()比对原始内容 - 读取失败（
false）比写入失败更值得警惕——说明文件虽建了但不可读，后续程序大概率崩 - 不要用
filesize()替代内容校验：空文件、截断写、编码转换都可能导致大小一致但内容错误
$content = 'secret_key=abc123';
$res = file_put_contents('/etc/myapp/key.conf', $content);
if ($res !== false && file_get_contents('/etc/myapp/key.conf') === $content) {
echo '可信写入完成';
} else {
echo '写入异常：内容不匹配或无法读回';
}
权限与 SELinux 导致的“静默失败”排查
Linux 下 PHP 写入失败却不报错，八成是权限或安全模块拦住了。Apache/Nginx 用户（如 www-data 或 nginx）可能有写权限，但没执行权限进目录，或 SELinux 策略禁止 httpd_t 写入非标准路径。
- 用
ls -ld /target/dir看目录权限，确认组/其他用户有w位；用ps aux | grep apache确认实际运行用户 - 临时关 SELinux 测试：
setenforce 0；若恢复写入，则需chcon -t httpd_sys_rw_content_t /path或改策略 - 容器环境注意：挂载卷是否设为
:rw，且宿主机对应路径对容器内 UID 可写
真正难缠的不是语法错，是这些底层约束让 fopen() 返回 false 却不吐错误信息，必须结合 error_get_last() 和系统日志一起看。
