PHP 二进制文件操作必须使用带 b 标志的 fopen 模式(如 'wb'、'rb'),否则 Windows 下换行符会被自动转换,导致数据损坏;file_put_contents() 不适用二进制场景,应手动 fopen + fwrite。

用 fopen() 打开文件时必须加 b 标志
PHP 在 Windows 下对换行符(\n 和 \r\n)有自动转换行为,不加 b 会导致二进制内容被意外修改。即使在 Linux/macOS 上,显式加 b 也是跨平台安全做法。
正确写法是:fopen('file.dat', 'wb')(写)、fopen('file.dat', 'rb')(读)、fopen('file.dat', 'w+b')(读写)——b 必须紧跟在模式字母后,不能隔开或省略。
-
'w'和'wb'行为不同:前者在 Windows 写\n会变成\r\n;后者原样写入 - 如果用
'a'追加,也得写成'ab',否则末尾可能多出回车换行 - PHP 8.1+ 对缺失
b的文本模式在二进制场景会触发E_DEPRECATED警告
写入二进制数据必须用 fwrite(),别用 file_put_contents() 默认行为
file_put_contents() 默认按文本模式处理,且不接受二进制标志参数。它内部调用的仍是 fopen(..., 'w'),不是 'wb'。
安全做法是手动控制流:
立即学习“PHP免费学习笔记(深入)”;
采用 php+mysql 数据库方式运行的强大网上商店系统,执行效率高速度快,支持多语言,模板和代码分离,轻松创建属于自己的个性化用户界面 v3.5更新: 1).进一步静态化了活动商品. 2).提供了一些重要UFT-8转换文件 3).修复了除了网银在线支付其它支付显示错误的问题. 4).修改了LOGO广告管理,增加LOGO链接后主页LOGO路径错误的问题 5).修改了公告无法发布的问题,可能是打压
$fp = fopen('data.bin', 'wb');
if ($fp) {
fwrite($fp, "\x00\x01\xFF\xAB");
fclose($fp);
}- 如果坚持用
file_put_contents(),需确保传入的是原始字节字符串(如 hex2bin() 结果),且目标系统是 Unix-like —— 但这不解决 Windows 换行污染问题 -
pack()生成的二进制数据必须配合fwrite()+'wb'使用,否则结构错乱 - 不要用
echo或print向文件句柄输出二进制内容,它们会触发输出缓冲和编码转换
检查文件是否真按二进制写入:用 hexdump 或 xxd 验证
光看文件大小或能否打开没用。Windows 记事本打开二进制文件显示乱码是正常现象;关键看字节是否与预期一致。
终端快速验证方式:
xxd data.bin # 或 hexdump -C data.bin
- 如果写入
"\x00\x01\xFF"却看到00 01 0d 0a ff,说明被当作文本模式处理了(多了\r\n) - PHP 中可用
file_get_contents()读回来再bin2hex()对比,但注意读也要用'rb'模式 - 某些 IDE(如 VS Code)默认以 UTF-8 解码文件,显示异常不代表写入错误;务必用十六进制查看器确认
常见踩坑:用 fputs()、fprintf() 写二进制数据
fputs() 是 fwrite() 别名,可用;但 fprintf() 是格式化函数,会做类型转换和字符串拼接,完全不适合二进制场景。
-
fprintf($fp, '%c%c', 0, 255)看似能写字节,实际依赖 locale 和格式解析,不可靠 -
fputs($fp, "\x00\x01")可以,但不如fwrite()明确,且 PHP 文档已标记fputs()为 legacy - 从网络/数据库读来的二进制数据(如图片 blob、加密密文),直接
fwrite()即可,无需base64_decode()或其他预处理——除非你本来就是 base64 编码存的
二进制文件操作最易忽略的点,是把“文件内容看起来能读”当成“写入正确”。只要路径、权限、模式三者中有一个没对齐 b 标志,就可能在某个系统上悄悄损坏数据。










