php文件写入失败常见原因有四：权限不足导致fopen()返回false；编码不一致引发中文乱码；file_put_contents()并发写入丢数据；相对路径基准错误致文件写入位置异常。
PHP fopen() 模式选错会导致写入失败或覆盖错误
初学者常以为 "w" 和 "a" 只是“覆盖”和“追加”的区别，但实际影响远不止于此。比如用 "w" 打开一个只读文件（或父目录无写权限），fopen() 直接返回 false，后续 fwrite() 会报 Warning: fwrite() expects parameter 1 to be resource, bool given —— 这个错误提示里没提权限，容易误判。
-
"w"：清空文件内容再写；若文件不存在则创建；**要求目录可写，文件本身无需存在但必须可创建** -
"a"：光标移到末尾追加；文件不存在时自动创建；**只要目录可写即可，不检查原文件权限** -
"x"（推荐新手试用）：仅当文件**不存在**时创建并打开写入，失败直接返回false，避免意外覆盖已有配置文件
$fp = fopen('config.php', 'x');
if ($fp === false) {
die('文件已存在，拒绝覆盖！');
}
fwrite($fp, '<?php return [' . PHP_EOL);
fclose($fp);
中文内容写入乱码？别只改 header()，先看文件编码和 BOM
用 file_put_contents('log.txt', '用户登录成功') 写中文，浏览器打开是乱码，很多人急着加 header('Content-Type: text/plain; charset=utf-8')，但问题往往出在更底层：PHP 脚本自身保存为 ANSI 或 GBK，或者编辑器偷偷加了 UTF-8 BOM。
- 确认 PHP 文件本身是 UTF-8 无 BOM 编码（VS Code / PHPStorm 默认可能带 BOM，需在右下角点击编码后选 “Save with Encoding → UTF-8”）
- 写入前显式指定编码转换（尤其读取 POST 或数据库数据时）：
mb_convert_encoding($str, 'UTF-8', 'GBK') - 避免用记事本保存 PHP 文件——它默认 ANSI，且无法禁用 BOM
file_put_contents() 看似简单，但并发写入会丢数据
很多教程说 file_put_contents('counter.txt', $count) 是最简写法，但它底层不是原子操作：先 unlink() 再 fopen()+fwrite()。两个请求同时执行，可能出现 A 读到 100、B 也读到 100，各自加 1 后都写回 101，造成计数丢失。
Perl 基础入门中文教程，chm格式，讲述PERL概述、简单变量、操作符、列表和数组变量、文件读写、模式匹配、控制结构、子程序、关联数组/哈希表、格式化输出、文件系统、引用、面向对象、包和模块等知识点。适合初学者阅读和了解Perl脚本语言。
- 单次写入且无并发需求（如日志快照、临时配置生成）可用
file_put_contents() - 需要可靠追加（如访问日志），加上
FILE_APPEND | LOCK_EX标志：file_put_contents('access.log', $line . PHP_EOL, FILE_APPEND | LOCK_EX) - 高频计数/状态更新场景，换 Redis 或数据库，文件不是合适载体
路径错误不报错，但文件写进奇怪地方
fopen('data.txt', 'w') 看起来没问题，但执行后死活找不到文件？PHP 默认以**当前执行脚本所在目录**为相对路径基准，不是浏览器访问路径，也不是命令行 pwd 路径。如果通过 Web 访问 /admin/update.php，而该脚本位于 /var/www/html/admin/，那么 data.txt 就会出现在 /var/www/html/admin/ 下，而非网站根目录。
立即学习“PHP免费学习笔记（深入）”；
- 用
__DIR__显式拼接绝对路径：fopen(__DIR__ . '/logs/error.log', 'a') - 检查
getcwd()输出，确认当前工作目录是否符合预期 - 写入前用
is_writable(dirname($path))验证目标目录可写，比靠报错更主动
权限、编码、路径、并发——这四点漏掉任一，都会让“简单写个文件”变成卡半天的调试现场。尤其是 LOCK_EX 和 __DIR__，新手常跳过，等线上出问题才回头补。
