应将自定义助手函数放在 app/Support/Helpers.php 并通过 composer.json 的 autoload.files 字段注册，确保 Composer 自动加载；避免使用服务提供者或手动 require，且函数需无状态、不依赖请求上下文。
自定义助手函数该放哪？别往 app/Helpers 里硬塞
Laravel 默认不加载任何全局助手函数，app/Helpers 目录只是你建的，PHP 根本不认识它。直接写函数、放文件、不注册，运行时会报 Call to undefined function。关键不是“放哪”，而是“怎么让 Composer 自动载入”。
- 推荐路径：
app/Support/Helpers.php（或app/Helpers.php，但避免用目录名和类名冲突） - 文件必须是纯 PHP，只包含函数声明，不能有命名空间、不能有
class或return - 函数名需全局唯一，避免和 Laravel 内置（如
str,value）或第三方包冲突
如何让 composer.json 正确加载 helpers 文件
靠 Composer 的 autoload.files 字段，这是唯一稳定、符合 PSR-4 补充规范的做法。别用服务提供者注册函数——函数不是对象，无法绑定容器，强行 bind 只会增加启动开销且无意义。
- 编辑
composer.json，在"autoload"下添加：
"autoload": {
"files": [
"app/Support/Helpers.php"
],
"psr-4": {
"App\": "app/",
"Database\Factories\": "database/factories/",
"Database\Seeders\": "database/seeders/"
}
}
- 改完立刻执行：
composer dump-autoload（开发中可加-o优化，但首次不用） - 如果已运行过
composer install或update，仅改 JSON 不生效，必须重跑 autoload
为什么不能用 helpers.php 放在 bootstrap/ 下？
旧版 Laravel（5.5 之前）确实有人这么干，但现在行不通。Laravel 6+ 启动流程中，bootstrap/app.php 创建应用实例后才加载 vendor/autoload.php，而 bootstrap/helpers.php 若未被 Composer 管理，就会变成“定义了但没加载”的幽灵文件。
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
-
bootstrap/helpers.php不会被自动引入，除非你在public/index.php或artisan里手动require_once—— 这破坏一致性，测试、队列、Schedule 都可能漏掉 - 某些 IDE（如 PHPStorm）能识别
autoload.files，但对手动 require 的文件补全支持弱 - 部署时若用
composer install --no-dev --optimize-autoloader，只有autoload.files里的才会被合并进优化后的 autoloader
函数里用 Facade 或依赖注入？小心循环调用和上下文丢失
助手函数本质是全局作用域，没有请求上下文、没有容器实例。直接调 app() 或 config() 看似可行，但隐含风险：
-
app('request')在 Artisan 命令或队列中可能为 null，导致Call to a member function xxx() on null - 用
DB::table()没问题，但用Auth::user()在非 Web 请求里必然失败 - 更安全的做法：把需要上下文的逻辑下沉到 Service 类，助手函数只做无状态转换（如格式化手机号、生成 slug）
比如这个常见坑：function current_user_name() { return Auth::user()?->name ?? 'Guest'; } —— 看起来简洁，实则在命令行里永远返回 'Guest'，还掩盖了真实问题。
