Composer 的 files 自动加载机制要求路径严格匹配文件系统实际大小写，Laravel 项目中将 "App/Helpers/Helper.php" 写为 "app/Helpers/Helper.php" 才能正确加载。
composer 的 `files` 自动加载机制要求路径严格匹配文件系统实际大小写，laravel 项目中将 `"app/helpers/helper.php"` 写为 `"app/helpers/helper.php"` 才能正确加载。
在 Laravel（或任何基于 Composer 的 PHP 项目）中，composer.json 的 "files" 字段用于声明需在每次自动加载时一次性引入的全局函数文件（如工具函数、辅助函数等）。该机制看似简单，却极易因一个细微的大小写差异而失败——尤其在类 Unix 系统（Linux/macOS）或 Docker 容器中，文件系统默认区分大小写，而开发者常受 Windows 开发环境影响忽略此细节。
你遇到的错误：
require(/var/www/html/acessoportal/vendor/composer/../../App/Helpers/Helper.php): Failed to open stream: No such file or directory
根本原因正是路径中的 App（首字母大写）与实际目录名 app（全小写）不一致。Composer 在生成 vendor/autoload.php 时，会将 "files" 数组中的路径原样拼接到项目根目录，并尝试 require。若路径不存在（如 App/Helpers/Helper.php），则 post-autoload-dump 脚本直接中断，导致 composer install 或 composer dump-autoload 失败。
✅ 正确写法（适配 Laravel 标准目录结构）：
"autoload": {
"psr-4": {
"App\": "app/",
"Database\Factories\": "database/factories/",
"Database\Seeders\": "database/seeders/"
},
"files": [
"app/Helpers/Helper.php"
]
}⚠️ 关键注意事项：
- 路径是相对于项目根目录的，且必须完全匹配磁盘上的真实路径大小写：app/ ≠ App/ ≠ APP/；
- 修改 composer.json 后，必须重新执行 composer dump-autoload（或 composer install/update），否则变更不会生效；
- 建议统一使用小写路径命名约定（符合 PSR-4 和 Laravel 社区惯例），避免跨平台兼容性风险；
- 可通过终端快速验证路径是否存在：
ls -l app/Helpers/Helper.php # 确认文件存在且路径准确
? 补充技巧：若 Helper.php 中定义了全局函数，建议用 function_exists() 包裹防止重复加载（尽管 files 仅加载一次，但利于代码健壮性）：
// app/Helpers/Helper.php
if (!function_exists('str_slug')) {
function str_slug($string) {
return strtolower(trim(preg_replace('/[^A-Za-z0-9-]+/', '-', $string), '-'));
}
}最后，请记住：Composer 的自动加载不是“智能查找”，而是“精确路径映射”。尊重文件系统的大小写规则，是保障自动化流程稳定的第一步。
