在PHP中缩短过长文件名的方案咨询,需保留首尾及后缀信息
文件名截断实现答疑
现有代码的问题
你当前的实现仅能匹配你给出的固定测试样例,不具备通用性,不能算作正确的通用实现,核心问题如下:
- 硬编码取前7位、后7位的逻辑不合理:如果原文件名本身长度小于14位,会出现不必要的截断,甚至出现内容重复,比如文件名为
a.png时,会输出a...a.png - 未兼容不同长度的文件后缀:如果遇到
.docx/.tar.gz这类长度更长的后缀,取后7位会导致后缀显示不全,用户无法判断文件类型 - 逻辑代码和HTML标签混写:直接输出
<pre>标签会破坏页面结构,不符合代码分层的规范
更优实现方案
核心思路
先拆分文件名的主名和后缀,优先保证文件后缀完整展示,再根据预设的最大展示长度判断是否需要截断,短文件名直接返回原名称,长文件名再做截断处理,同时支持自定义展示长度、末尾随机数保留位数。
代码实现
/** * 截断长文件名,保留前缀、省略号、末尾随机位、完整后缀 * @param string $fileName 原文件名 * @param int $maxShowLength 允许的最大展示长度,默认14位 * @param int $randomKeepLength 末尾随机数保留位数,默认3位 * @return string 处理后的文件名 */ function truncateFileName(string $fileName, int $maxShowLength = 14, int $randomKeepLength = 3): string { $originLen = strlen($fileName); // 长度小于要求直接返回原文件名 if ($originLen <= $maxShowLength) { return $fileName; } // 拆分文件名和后缀 $fileInfo = pathinfo($fileName); $suffix = $fileInfo['extension'] ?? ''; $mainName = $fileInfo['filename'] ?? $fileName; // 无后缀场景直接截断主名 if (empty($suffix)) { return substr($mainName, 0, $maxShowLength - 3) . '...'; } // 计算前缀可保留的长度 $prefixKeepLen = $maxShowLength - 3 - $randomKeepLength - strlen($suffix) - 1; $prefix = substr($mainName, 0, $prefixKeepLen); $randomPart = substr($mainName, -$randomKeepLength); return "{$prefix}...{$randomPart}.{$suffix}"; } // 测试用例 $testCases = [ "example_of_the_file_8765366763.png", "example_of_the_file_8765366763.jpeg", "example_of_the_file_8765366763.jpg", "example_of_the_file_8765366763.pdf", "example_of_the_file_8765366763.ppt", "test.png", "longfilenamewithoutextension" ]; foreach ($testCases as $case) { echo truncateFileName($case) . PHP_EOL; }
方案优势
- 兼容所有场景:短文件名不截断,长文件名按规则截断,同时支持无后缀文件
- 后缀完整展示:用户可以直接识别文件类型,符合使用习惯
- 可灵活配置:支持根据前端展示容器的大小调整最大展示长度、末尾随机数保留位数
- 代码分层清晰:函数仅返回处理后的字符串,可自由适配不同的渲染场景
内容的提问来源于stack exchange,提问作者Naren Verma
相关产品推荐
相关产品推荐

