本文详解在 laravel 文件上传场景中，如何精准替换文件名中的阿拉伯数字（如٠١٢）为标准 ascii 数字（012），避免误改文件对象本身或生成临时文件名（如 phpf77e.tmp），确保原始文件结构与可读性不受损。
本文详解在 laravel 文件上传场景中，如何精准替换文件名中的阿拉伯数字（如٠١٢）为标准 ascii 数字（012），避免误改文件对象本身或生成临时文件名（如 phpf77e.tmp），确保原始文件结构与可读性不受损。
在 Laravel 中处理用户上传的文件时，若文件名包含阿拉伯语系使用的东阿拉伯数字（٠ ١ ٢ ٣ ٤ ٥ ٦ ٧ ٨ ٩），直接使用 preg_replace() 配合数组参数会因正则语法错误导致意外行为——例如返回空值、临时文件名（如 phpF77E.tmp），根本原因在于 preg_replace($pattern, $replacement, $subject) 的 $pattern 必须是正则表达式字符串或字符串数组（需转义），而你传入的是纯字符数组，PHP 将其强制转换为正则模式时未加分隔符和转义，引发未定义行为。
✅ 正确做法是：仅对文件名（字符串）进行数字替换，而非对 UploadedFile 对象整体操作。$file 是 Illuminate\Http\UploadedFile 实例，直接传给 convert() 会导致对象被隐式转换为字符串（即临时路径），从而“替换”出错。
以下是推荐的健壮实现流程：
1. 提取原始文件名并转换数字
public function convertFileName(string $filename): string
{
$arabicEastern = ['٠', '١', '٢', '٣', '٤', '٥', '٦', '٧', '٨', '٩'];
$westernDigits = ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9'];
return str_replace($arabicEastern, $westernDigits, $filename);
}
✅ 使用
str_replace()（非正则）更安全、高效，且完全支持字符数组批量替换；避免preg_replace()的模式解析风险。
2. 在上传逻辑中正确调用
public function storeCv(Request $request, $trainee_id)
{
$request->validate([
'cv' => 'required_without:file',
'file' => 'required_without:cv',
]);
$trainee = Trainee::findOrFail($trainee_id);
$file = $request->file('cv') ?: $request->file('file');
// ✅ 关键修正：仅处理文件名，不传 $file 对象进 convert()
$originalName = $file->getClientOriginalName();
$safeFilename = $this->convertFileName($originalName);
// ✅ 使用 storeAs 显式保存（推荐用于自定义命名）
$path = $file->storeAs(
'cv', // 子目录
$safeFilename,
['disk' => 'uploads'] // 指向自定义磁盘（见下方配置）
);
// ✅ 将存储后的路径/文件名传入 media-library
$uploaded_file = $trainee->uploadToFolder($path, 'cv');
if ($trainee->cv_url) {
$trainee->status = Trainee::STATUS_PENDING_APPROVAL;
$trainee->save();
}
return $uploaded_file;
}
3. 配置自定义文件磁盘（config/filesystems.php）
'disks' => [
'uploads' => [
'driver' => 'local',
'root' => public_path('uploads'),
'url' => env('APP_URL').'/uploads',
'visibility' => 'public',
],
// ... 其他磁盘
],
⚠️ 注意事项
-
永远不要对
UploadedFile对象调用字符串替换函数：$file是对象，str_replace($file, ...)会触发__toString()返回临时路径，造成逻辑错乱。 -
避免
preg_replace数组误用：preg_replace(['٠','١'], ['0','1'], $str)是非法的——它会被解释为preg_replace(['\x{0660}', '\x{0661}'], ...), 但缺少分隔符且未声明 Unicode 模式（uflag），极易失败。 -
保留扩展名安全性：
getClientOriginalName()已含扩展名，convertFileName()仅替换数字，不会破坏.pdf、.docx等后缀。 -
增强兼容性（可选）：如需同时处理波斯/乌尔都数字（۰۱۲…），可扩展
$arabicEastern数组。
通过以上方式，你既能精准清洗文件名中的非 ASCII 数字，又能确保文件实体完整上传，彻底规避 phpXXXX.tmp 类错误，提升系统对多语言用户的兼容性与鲁棒性。
