本文介绍如何使用 var_export() 将 php 数组持久化写入文件，并支持增量更新——即只修改指定键值、保留其他配置项，避免全量重写导致数据丢失。
在实际开发中，直接拼接字符串生成 PHP 配置文件（如 $config['title'] = 'Demo title';）虽简单，但难以维护：每次调用都会覆盖整个文件，无法实现“仅更新某一项”或“新增不干扰旧项”的语义。更健壮的做法是 读取→修改→导出→写入 的闭环流程。
✅ 推荐方案：用 var_export() 实现可维护的数组序列化
var_export() 能将任意 PHP 变量（包括嵌套数组）转换为合法、可直接 include 的 PHP 代码字符串，且格式清晰、自动转义、兼容性强。配合 file_get_contents() 和 include，即可实现安全的配置读写：
// 1. 读取现有配置（若文件存在）
$configPath = $_SERVER['DOCUMENT_ROOT'] . '/settings.php';
$config = [];
if (file_exists($configPath)) {
// 使用 include 获取数组（需确保 settings.php 仅返回 $config 数组定义）
$tempConfig = [];
include $configPath;
$config = $tempConfig ?? [];
}
// 2. 修改/新增键值（仅操作内存中的数组）
$config['title'] = 'New Title';
$config['version'] = '2.1.0';
$config['debug'] = true;
// 3. 序列化并写入文件（带 PHP 标签和变量声明）
$configCode = '<?php' . PHP_EOL . '$config = ' . var_export($config, true) . ';';
// 使用 file_put_contents + LOCK_EX 确保原子写入
if (file_put_contents($configPath, $configCode, LOCK_EX) === false) {
throw new RuntimeException("Failed to write config to {$configPath}");
}⚠️ 注意事项：settings.php 必须是纯配置文件（无副作用逻辑），且必须以 $config = [...] 形式定义数组；若原文件不存在，上述代码会自动创建；若存在，则先加载再合并，天然支持增量更新；var_export($config, true) 的第二个参数 true 表示返回字符串而非直接输出，这是关键；使用 LOCK_EX 可防止并发写入冲突，比手动 fopen + flock 更简洁可靠。
? 进阶建议
- 对敏感配置（如数据库密码），建议将 settings.php 放在 Web 根目录之外，或通过 .htaccess / nginx 禁止直接访问；
- 可封装为 ConfigManager 类，增加类型校验、变更日志、备份机制；
- 如需更高性能或复杂结构，可考虑 JSON/YAML 格式 + 自定义加载器，但 PHP 原生数组仍是开发期最直观的选择。
通过该方式，你不再需要手动拼接字符串、处理引号转义或担心键名冲突——一切交由 var_export() 安全处理，真正实现“改一处、存全局、零丢失”。
