Laravel自定义辅助函数需通过composer.json的files字段配置并执行dump-autoload才能自动加载，文件应放于app/Helpers等目录，函数须定义在顶层作用域且避免命名冲突。
自定义辅助函数文件怎么放才被自动加载
Laravel 默认不提供全局辅助函数的自动加载机制，必须通过 Composer 的 autoload 配置显式声明。文件位置无所谓，但推荐放在 app/Helpers 目录下（如 app/Helpers/StrHelper.php），避免和框架核心或第三方包冲突。
关键不是路径，而是 Composer 能否在 dump-autoload 时把该文件纳入自动加载清单。只要配置正确，哪怕放在 resources/aux/ 下也能生效。
composer.json 中 autoload 部分怎么写
必须使用 files 类型（不是 psr-4），因为辅助函数是纯函数集合，没有命名空间和类结构。在 composer.json 的 autoload 和 autoload-dev（可选）下添加：
{
"autoload": {
"files": [
"app/Helpers/StrHelper.php",
"app/Helpers/ArrayHelper.php"
]
},
"autoload-dev": {
"files": [
"tests/Support/TestCaseHelper.php"
]
}
}
注意：files 数组里的路径是相对于 composer.json 所在目录（即项目根目录）的相对路径；每增删一个辅助文件，都必须重新运行 composer dump-autoload。
辅助函数文件里不能写什么
这类文件会被 Composer 在启动时直接 include_once，所以要严格遵守以下限制：
- 不能定义类、接口、trait —— 否则会和 PSR-4 加载冲突，报
Cannot declare class XXX, because the name is already in use - 不能重复定义同名函数 —— PHP 会抛出
Cannot redeclare xxx()，尤其在测试多进程或热重载场景下容易触发 - 不要写
return、exit或输出语句（如echo）—— 可能破坏响应流程或导致空白页 - 函数名建议加前缀（如
helper_或app_），避免和 Laravel 内置函数（如str()、value()）或未来版本冲突
为什么改了函数不生效，或者报函数未定义
最常见原因有三个：
-
composer dump-autoload没执行 —— 修改composer.json或新增辅助文件后必须手动运行该命令 - 函数定义在
if或作用域块内 —— PHP 函数必须在顶层作用域中声明，否则自动加载时不会注册到全局符号表 -
开发环境用了 OPCache 且未清除 —— 尤其在 Homestead / Valet / Docker 中，需执行
php artisan opcache:clear或重启 Web 服务
验证是否加载成功：在 php artisan tinker 中直接调用函数，或在控制器里 dd(function_exists('your_helper_func'))。
