Composer autoload 文件类型无优先级顺序，实际生效取决于类名匹配时首个命中规则：psr-4/psr-0 按命名空间前缀匹配，classmap 全匹配且优先级高于 files，files 无条件 require_once 全局脚本但不依赖类名。
composer.json 里 autoload 的文件类型加载顺序怎么定
Composer 不支持「按文件类型设置优先级」，autoload 配置中所有规则是并列生效的，没有先后覆盖逻辑。真正起决定作用的是「类名匹配时第一个命中规则」——也就是说，谁的 psr-4 命名空间或 files 路径最先匹配到你要 require 的类/函数，谁就生效。
常见误解是以为把 files 放在 psr-4 前面就能“优先加载”，其实不是：只要类名符合某个 psr-4 映射，Composer 就直接按路径拼接去加载，根本不会去查 files；只有类名完全不匹配任何命名空间规则时，才会 fallback 到 classmap 或 files（但 files 是无条件全载入的，和类名无关）。
-
psr-4和psr-0按命名空间前缀匹配，精确到目录结构 -
classmap是扫描生成的静态映射表，类名全匹配，优先级高于files -
files是每次请求都强制require_once的全局脚本，不依赖类名，但无法按需加载
用 autoload.files 引入全局函数的正确写法
想让自定义函数（比如 helpers.php 里的 str_slug()）在项目任意位置直接调用，必须走 autoload.files，且要确保该文件只包含函数声明、无副作用（不能有 echo、new 实例、执行逻辑）。
示例配置：
{
"autoload": {
"files": [
"src/Helpers/functions.php",
"app/Support/helpers.php"
]
}
}
然后运行 composer dump-autoload 生效。注意：
- 路径是相对于
composer.json所在目录的相对路径 - 多个文件会按数组顺序依次
require_once，但彼此间无依赖顺序保障 - 如果函数重名，后加载的会覆盖先加载的（PHP 函数不能重复声明，运行时报
Fatal error: Cannot redeclare xxx()） - 修改
files后必须重新 dump，否则新增函数不可用
为什么 files 加载后函数还是找不到
典型现象：配置写了、dump 了、也确认路径存在，但调用时提示 Call to undefined function。最常见原因有三个：
- 路径写错，比如漏了
src/前缀，或用了绝对路径（Composer 只接受相对路径） - 文件里用了
namespace，导致函数实际在命名空间下，必须带前缀调用（如AppHelpersstr_slug()），而你直接写了str_slug() -
composer dump-autoload没加-o或--optimize，但在某些环境（如生产）启用了 classmap 优化，此时files规则可能被忽略——应始终加-o确保生成完整 autoload map
验证是否生效：检查 vendor/autoload.php 是否包含了类似 require __DIR__ . '/../src/Helpers/functions.php'; 的行。
替代方案：用 classmap + 工具类封装全局函数
如果你发现 files 太难控制（比如函数冲突、调试困难、IDE 不识别），更稳妥的做法是把函数收进一个工具类，用 psr-4 自动加载：
// src/Helper/Str.php
<?php
namespace AppHelper;
class Str
{
public static function slug(string $s): string
{
return strtolower(preg_replace('/[^a-z0-9]+/', '-', $s));
}
}
对应 composer.json：
{
"autoload": {
"psr-4": {
"App\": "src/"
}
}
}
调用时用 AppHelperStr::slug()。好处是 IDE 补全好、可单元测试、无命名污染，缺点是多敲几个字。对长期维护的项目，这比裸 files 更可控。
真正容易被忽略的是：files 的加载时机在 autoloader 初始化阶段，一旦加载完成就固定了；而函数定义本身没有自动重载机制，改完 .php 文件不重启 PHP-FPM 或 CLI 进程，旧版本函数仍驻留在内存里。
