psr-4无法加载全局函数，因其仅映射类名到文件且不执行函数注册；必须用files字段显式声明函数文件，分层配置psr-4管类、files管函数，否则函数调用会报“undefined function”错误。
混合使用命名空间类和全局函数时，不能靠一套 autoload 规则“一锅端”——PSR-4 不处理函数，files 不加载类，强行混用只会导致部分代码永远找不到。
为什么 PSR-4 加载不了全局函数
PSR-4 是为类设计的：它把 AppControllerUser 映射到 src/Controller/User.php，前提是这个文件里定义的是 class User。如果里面写的是 function helper()，Composer 会加载文件，但 PHP 不会自动注册函数；更糟的是，若该文件没有类，PSR-4 在某些优化模式（如 --classmap-authoritative）下甚至跳过加载。
常见错误现象：Fatal error: Uncaught Error: Call to undefined function helper()，而你确认 helper() 就在 src/functions.php 里。
- PSR-4 只响应类名请求，不响应函数调用
- 即使文件被 require_once，PHP 也不会“扫描并注册所有函数”
-
files字段才是唯一能保证全局函数被无条件加载的机制
如何同时支持命名空间类 + 全局函数
必须分层配置，各自归位：
- 用
psr-4管理所有带命名空间的类（如RedeStore→app/model_common/Rede/Store.php） - 用
files字段显式列出每个含全局函数的文件（如"src/functions.php"、"legacy/helpers.php"） - 绝不把函数文件塞进 PSR-4 路径下指望“顺带加载”——那只是偶然生效，且不可靠
示例 composer.json 片段：
{
"autoload": {
"psr-4": {
"Rede\": "app/model_common/Rede/",
"App\": "src/"
},
"files": [
"src/functions.php",
"legacy/global_utils.php"
]
}
}
注意：files 中路径是相对于 composer.json 所在目录的，且必须是真实存在的 PHP 文件（不能是目录）。
classmap 和 files 混用时的优先级陷阱
classmap 会提前拦截类加载请求，但它对函数完全无效；而 files 是在 autoloader 初始化时就一次性 require_once，与类加载流程无关。
容易踩的坑：
- 把
functions.php加进classmap：它会被扫描，但函数仍不会注册，因为 classmap 只建“类→文件”映射，不执行文件 - 误以为
files支持通配符（如"src/*.php"）：不支持，必须逐个列出 - 开发环境用了
autoload-dev.files，但生产部署没跑composer install --no-dev：dev 下的函数文件在 prod 里根本不会加载
验证是否真正生效的三步检查法
别只信 composer dump-autoload 输出成功，要实锤：
- 运行
php -r "require 'vendor/autoload.php'; var_dump(function_exists('your_helper'));"—— 直接测函数是否存在 - 查
vendor/composer/autoload_files.php，确认你的函数文件路径已出现在$files = array(...)列表中 - 临时删掉
vendor/autoload.php再重生成，排除旧缓存干扰
最常被忽略的一点：全局函数文件里不能有语法错误，哪怕一个多余逗号，都会让整个 files 加载中断，且无提示——PHP 的 require_once 失败时默认静默终止脚本初始化。
