应使用php脚本而非shell命令备份中文名配置文件，因shell在windows/macos/linux下对中文路径处理不一致；需在php中调用copy()并设置locale，配合pre-install-cmd钩子执行，并通过verify-backup.php校验备份有效性。
Composer安装前自动备份中文名配置文件
Composer本身不支持对含中文路径的文件做预处理，scripts 中的 pre-install-cmd 钩子能触发，但直接用 cp 或 copy 在 Windows/macOS/Linux 下对中文文件名行为不一致——Windows CMD 会乱码，macOS 的默认终端可能未设 UTF-8 locale，Linux 某些 shell 环境下 glob 不匹配中文名。
可靠做法是：改用 PHP 脚本执行备份，绕过 shell 编码问题。在项目根目录建 scripts/backup-config.php：
<?php $configFile = '配置文件.json'; // 替换为你的中文名文件
$backupDir = 'backup';
if (!is_dir($backupDir)) {
mkdir($backupDir, 0755, true);
}
$timestamp = date('Ymd-His');
$backupPath = $backupDir . '/'. $timestamp . '-' . basename($configFile);
if (file_exists($configFile)) {
if (copy($configFile, $backupPath)) {
echo "✅ 已备份: {$configFile} → {$backupPath}\n";
} else {
echo "❌ 备份失败: {$configFile}\n";
exit(1);
}
} else {
echo "⚠️ 文件不存在，跳过备份: {$configFile}\n";
}
然后在 composer.json 的 scripts 中注册：
"scripts": {
"pre-install-cmd": [
"php scripts/backup-config.php"
],
"pre-update-cmd": [
"php scripts/backup-config.php"
]
}
为什么不能用 shell 命令直接备份中文文件
常见错误是写成 "pre-install-cmd": "cp 配置文件.json backup/backup-$(date +%s).json"，这在多数环境会失败：
- Windows CMD / PowerShell 默认不识别 UTF-8 文件名，
cp或copy报“系统找不到指定的文件” - Linux/macOS 的
sh（非bash）可能不支持$()语法或date输出含空格时未加引号，导致命令截断 - Composer 的 script 执行器对 shell 元字符（如空格、括号、中文）转义不可靠，尤其跨平台时
- 即使命令看似成功，
ls backup/可能显示乱码名，实际文件已损坏或未写入
Composer更新后校验备份是否生效
仅靠钩子触发不等于备份一定成功。需要加两层防护：
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 在
post-install-cmd和post-update-cmd中补一个简单校验脚本，检查最新备份文件是否存在且大小 > 0 - 把
backup/加入.gitignore，但保留backup/.keep（空文件），避免 Git 误删整个目录 - 若配置文件是敏感内容（如含 API Key），别把
backup/提交到仓库；如需审计，可改用加密压缩（openssl enc）再备份，但会增加恢复复杂度
示例校验脚本 scripts/verify-backup.php：
<?php $backupDir = 'backup';
$files = glob($backupDir . '/*-配置文件.json');
if (empty($files)) {
echo "? 未找到任何中文名配置文件备份\n";
exit(1);
}
$latest = array_reduce($files, function ($a, $b) {
return filemtime($a) > filemtime($b) ? $a : $b;
});
if (filesize($latest) === 0) {
echo "? 最新备份 {$latest} 为空\n";
exit(1);
}
echo "✅ 最新备份有效: " . basename($latest) . "\n";
多个中文配置文件怎么批量处理
不要为每个文件写单独脚本。改用数组声明文件列表，统一处理：
$filesToBackup = [
'数据库配置.php',
'接口密钥.json',
'日志设置.ini'
];
foreach ($filesToBackup as $file) {
if (file_exists($file)) {
$backupPath = $backupDir . '/' . date('Ymd-His') . '-' . $file;
copy($file, $backupPath);
}
}
注意点：
- 确保这些文件名在所有开发机和 CI 环境中编码一致（推荐全部保存为 UTF-8 without BOM）
- 如果某台机器上文件系统是 FAT32（如某些 U 盘或旧 Windows），不支持中文长文件名，备份会静默失败——应优先排查存储介质
- Composer 2.2+ 支持
COMPOSER_ALLOW_SUPERUSER=1等变量，但跟中文文件无关；别误以为开这个就能解决编码问题
最易被忽略的是：PHP 的 copy() 函数在 Windows 上对中文路径要求 Web 服务器或 CLI 的 locale 必须为 Chinese_China.936 或 UTF-8，而默认 CLI locale 常是 C。解决方法是在脚本开头加 setlocale(LC_ALL, 'zh_CN.UTF-8', 'Chinese_China.936', 'UTF-8');，否则即使文件存在，file_exists() 也会返回 false。
