Composer 的 files 自动加载类型用于直接加载指定 PHP 文件（如全局函数或常量），在自动加载初始化时按序 require_once，路径相对 composer.json，需避免副作用和函数名冲突。
Composer 的 files 自动加载类型用于直接加载指定的 PHP 文件（通常是定义全局函数或常量的文件），在项目启动时自动引入，无需手动 require 或 include。它不依赖命名空间或类名，适合加载工具函数、辅助函数等。
在 composer.json 中配置 files 加载
在 composer.json 的 autoload 或 autoload-dev 字段下，用 files 键声明一个文件路径数组：
{
"autoload": {
"files": [
"src/Helpers.php",
"src/functions.php"
]
},
"autoload-dev": {
"files": [
"tests/TestHelpers.php"
]
}
}
配置后运行 composer dump-autoload（或安装/更新时自动执行），Composer 就会在每次自动加载初始化时，按顺序 require_once 这些文件。
files 加载的注意事项
- 路径是相对于
composer.json所在目录的，支持相对路径和通配符（但不推荐用通配符，因 Composer 不原生支持 glob，需配合脚本或插件） - 文件只被加载一次（
require_once行为），重复包含不会报错 - 所有
files在 Composer 自动加载器初始化时立即执行，适合放函数定义，**不要放有副作用的运行时逻辑**（如 echo、header、数据库连接等） - 若函数已存在（例如被其他方式提前加载），PHP 会报
Fatal error: Cannot redeclare—— 确保函数名不冲突
典型使用场景示例
比如你在 src/Helpers.php 中定义了常用字符串处理函数：
// src/Helpers.php
if (!function_exists('str_slug')) {
function str_slug($string, $separator = '-') {
return strtolower(trim(preg_replace('/[^A-Za-z0-9-]+/', $separator, $string), $separator));
}
}
配置 "files": ["src/Helpers.php"] 后，在任何地方都能直接调用 str_slug('Hello World')，无需额外引入。
验证是否生效
可临时加一句调试代码到函数文件末尾（仅开发时）：
// src/Helpers.php echo "[Helpers.php loaded]\n"; // 仅用于确认加载时机 // ... 函数定义
然后执行一个简单脚本：php -r "var_dump(function_exists('str_slug'));"，返回 bool(true) 即表示成功加载。
基本上就这些。files 加载简单直接，适合轻量级函数集合，但不适合大型逻辑或需要延迟加载的场景。
