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。

Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

辅助函数文件里不能写什么

这类文件会被 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'))。