laravel全局辅助函数必须通过composer.json的"files"字段注册并执行composer dump-autoload，否则函数不存在；每个函数需用if(!function_exists())包裹，路径须相对于项目根目录，且文件不能含命名空间或输出。
必须手动注册，否则函数根本不存在——Laravel 不会自动扫描或加载任何 helpers.php 文件。
composer.json 的 "files" 字段是唯一可靠方式
PHP 的全局函数只能靠 Composer 的 autoload.files 加载，其他方法（如在 bootstrap/autoload.php 里 require_once、用服务提供者 require、放 app/Helpers/ 目录却不注册）都会在某些上下文失效（比如队列、Artisan 命令、Octane 长连接）。
- 路径必须写对：例如
"app/Support/Helpers.php"，注意是相对于项目根目录，不是app/目录内部 - 文件必须是纯 PHP，不能有
namespace、不能有class、不能有return或输出（空格、BOM、echo都会导致解析失败） - 改完
composer.json后，必须运行composer dump-autoload；加-o可选，但首次不强制 - 部署时若用了
--no-dev，确认"files"没被误删——它不属于 dev-only 配置
function_exists() 包裹是硬性要求
不加这层判断，一旦 Laravel 升级或引入新包带来同名函数（比如 retry()、value()），就会直接触发 Fatal error: Cannot redeclare xxx()。
- 每个函数定义前都得套一层：
if (!function_exists('my_format_phone')) { function my_format_phone(...) { ... } } - 别偷懒只包一次——多个函数就得多个
if块 - 命名建议带项目前缀，比如
acme_str_slug_safe()，而不是str_slug_safe() - 检查是否已存在：在终端执行
php -r "var_dump(function_exists('xxx'));"
为什么 artisan tinker 能用，HTTP 请求却报 undefined function
最常见原因是 autoload 没生效，或部署漏掉了文件注册。
- 运行
grep "app/Support/Helpers.php" vendor/autoload.php，确认路径确实被写进最终加载列表 - 检查
vendor/composer/autoload_files.php里有没有你那行路径 - 如果用了 Swoole / Octane，修改
Helpers.php后必须重启服务——不会热更新 - 用
php -l app/Support/Helpers.php检查语法错误，哪怕一个分号漏写也会让整个文件失效
真正容易被忽略的是路径的相对性：写成 "Helpers/Helpers.php" 看似简洁，但实际是从项目根目录开始解析，不是从 app/ 目录。错一格，函数就永远找不到。
