最稳妥方式是用 serialize 序列化数组后配合 file_put_contents 写入,可完整保留键类型、嵌套结构和对象;若需跨语言则用 json_encode(注意校验返回值);若要生成可直接 include 的 PHP 配置文件,则用 var_export。

PHP 用 fopen + serialize 写入数组到文件最稳妥
直接 file_put_contents 存数组会报错或写入乱码,因为 PHP 不允许把数组直接转成字符串写入文件。必须先序列化(serialize)或编码(如 json_encode),再写入。
推荐用 serialize,它能完整保留数组结构、键类型(包括整型键、字符串键)、嵌套关系,甚至对象(如果没特殊限制)。但注意:只能被 PHP 读取,其他语言无法解析。
-
serialize($arr)后用fopen+fwrite或直接file_put_contents写入 - 写入前建议加
is_array($arr)判断,避免传入 null 或 string 导致空文件或警告 - 文件路径需确保目录可写,否则
fopen返回false,不报错但写入失败
用 json_encode 存数组适合跨语言或前端交互场景
如果数组后续要被 JavaScript、Python 或配置工具读取,json_encode 是更通用的选择。但它有硬性限制:键名强制转为字符串,数字索引没问题,但关联键若含非法字符(如空格、点号、中文)可能引发解析问题;且不支持资源、闭包、部分对象。
- 写入时加上
JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT提高可读性(调试用) - 务必检查
json_encode返回值是否为false,常见原因:数组含不可序列化内容(如 resource)或循环引用 - 读取时用
json_decode($content, true),第二个参数true确保返回数组而非对象
var_export 写入适合生成 PHP 可直接 include 的配置文件
如果你需要生成一个“看起来像 PHP 代码”的数组文件(比如 config.php),var_export 是唯一能原样还原数组定义的函数。它输出的是合法 PHP 语法,可被 include 或 require 直接加载。
立即学习“PHP免费学习笔记(深入)”;
- 调用时加第二个参数
false(默认),让它返回字符串而非直接输出 - 写入前手动拼上
和分号,例如:" - 注意:
var_export对闭包、资源、某些扩展对象会报错,仅适用于纯数据数组
读取时别忘了反向操作,且要校验格式
写进去容易,读出来出错很常见。无论用哪种方式写入,读取都必须严格对应:
- 用
serialize写的,必须用unserialize(file_get_contents($file));但注意:反序列化不受信任数据有安全风险,生产环境慎用 - 用
json_encode写的,必须用json_decode(file_get_contents($file), true),且检查返回值是否为null(可能是 JSON 解析失败) - 用
var_export写的,推荐用include(自动返回数组),而不是eval;若用eval,必须确保文件内容完全可控 - 所有读取操作前建议加
file_exists($file) && is_readable($file)判断,避免 Warning
最易忽略的是:写入和读取用了不同编码方式(比如写用 json_encode,读却用 unserialize),结果得到 null 或乱码,连错误提示都没有——这种问题往往卡在测试环节很久才暴露。











