PHP fopen有哪些模式-php教程-PHP中文网

php fopen的mode参数合法值包括基础模式r、w、a、x及其加“+”的读写变体（r+、w+、a+、x+），可选修饰符b（二进制）必须显式添加以确保跨平台安全，t（文本）为隐式默认；网络url中mode仅占位无效。

php fopen有哪些模式

PHP fopen 的 mode 参数有哪些合法值

fopen() 的 mode 参数不是随便写的字符串，它必须是 PHP 明确支持的组合，否则会返回 false 且不报错（只触发警告）。常见错误是写成 "rw" 或 "read" 这类自定义字符串，结果文件打不开却查不出原因。

合法值分两类：基础模式 + 可选修饰符
基础模式必须存在且只能有一个（如 "r"、"w"、"a"、"x"），修饰符可追加但不可省略基础部分。

"r"：只读，文件必须存在；指针在开头
"w"：只写，存在则清空，不存在则创建；指针在开头
"a"：追加写，存在则指针自动移到末尾，不存在则创建
"x"：仅创建写，文件已存在时直接失败（返回 false），不覆盖
"r+"、"w+"、"a+"、"x+"：对应读写模式，注意 "w+" 和 "a+" 行为差异极大——前者清空内容，后者保留并追加

为什么必须加 "b" 才算真正安全

Windows 和 Linux 对换行符的处理不同："\r\n" vs "\n"。PHP 默认用文本模式（"t"，隐式启用），会在读写时自动转换换行符。这看似方便，实则埋雷：

读二进制文件（如图片、ZIP）时，"r" 可能损坏数据（比如把 0x0D 0x0A 错误转成单个 "\n"）
写入非文本内容时，"w" 可能多插入或丢失字节

正确做法是：所有非纯文本操作，显式加 "b"，例如：
"rb"、"wb"、"ab"、"r+b"
"b" 不影响 Linux/macOS，但在 Windows 上禁用换行符转换，保证字节级准确。

"x" 模式不是 "w" 的安全替代品

很多人以为 "x" 就是“带存在检查的 w”，其实它更严格：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

"x" 要求文件完全不存在，哪怕只是符号链接指向一个空文件，也会失败
它底层调用的是 O_EXCL | O_CREAT 系统调用，用于防止竞态条件（如两个进程同时创建同名文件）
但它不检查父目录权限：如果目录不可写，fopen("log/new.txt", "x") 仍会返回 false，但错误信息可能误导为“文件已存在”

使用 "x" 时务必配合错误检查：

$fp = fopen("config.lock", "x");
if ($fp === false) {
    // 不能只判断 file_exists() —— 可能是权限/磁盘满/路径不存在
    $err = error_get_last();
    error_log("fopen x failed: " . ($err['message'] ?? 'unknown'));
}