Composer autoload 仅识别 .php 后缀，.inc/.php5 等需通过 files 手动引入；classmap 可用软链临时绕过；非 PHP 文件不应走 autoload，应显式读取。
Composer autoload 只认 .php 后缀，其他后缀默认不加载
Composer 的 autoload（包括 psr-4、psr-0、classmap）在扫描和注册类时，**硬编码只识别 .php 文件**。即使你把 MyClass.php 改成 MyClass.inc 或 MyClass.php5，composer dump-autoload 也不会把它加入自动加载映射表——连警告都不会报。
这是由 Composer 源码中 Composer\Autoload\ClassMapGenerator 和 Composer\Autoload\Psr4Generator 内部的白名单决定的，不是配置能绕过的。
想加载 .inc、.php5、.php7 等非标准后缀？只能靠 files 类型手动引入
files 是 Composer 唯一支持「无条件预加载」的 autoload 方式，它不依赖文件名或命名空间，而是直接 require 那些路径明确的文件。适合加载函数库、常量定义、配置数组等非类结构。
操作步骤如下：
立即学习“PHP免费学习笔记（深入）”；
- 在
composer.json的autoload.files数组里写入绝对路径（相对于项目根目录）或通配路径（支持 glob） - 运行
composer dump-autoload - 这些文件会在每次
require 'vendor/autoload.php'时被立即执行
示例：
{
"autoload": {
"files": [
"src/helpers.inc",
"src/constants.php5",
"src/functions/*.php"
]
}
}
注意：files 不支持递归 glob（如 "src/**/*.inc"），只展开一层；若需多层，得写具体路径或用脚本生成列表。
classmap 能否绕过后缀限制？不能，但可以「骗过」扫描逻辑
classmap 本身也不支持自定义后缀，但它的工作方式是「先扫描，再生成映射表」。只要你在扫描前，把目标文件软链接为 .php 后缀，就能让它进 map。
比如你有一批 .inc 文件想当类用：
- 在
src/下建软链：ln -s Helper.inc Helper.php - 在
composer.json中配置："classmap": ["src/"] - 运行
composer dump-autoload——此时扫到的是Helper.php，但实际加载的仍是Helper.inc
这个技巧有效，但有隐患：git 不跟踪软链、CI 环境可能无权限建链、Windows 下不可靠。仅建议临时调试用。
加载非 PHP 文件（如 JSON、YAML、XML）？别走 autoload 这条路
Composer 的 autoload 机制本质是为「PHP 执行上下文」服务的，它的设计目标从来不是加载配置文件或资源。试图让 autoload 加载 .json 或 .yml，等于强行扭曲用途。
正确做法是：在需要的地方显式读取，例如：
- 用
json_decode(file_get_contents(__DIR__ . '/config.json'), true) - 用 Symfony 的
Yaml::parseFile() - 把配置封装进一个类里，在构造时加载，再通过
files或psr-4引入该类
硬塞进 autoload，只会让加载时机不可控、错误难追踪、IDE 支持变差——尤其当文件内容非法导致 parse error 时，会卡死整个自动加载流程。
真正容易被忽略的一点：哪怕你用 files 加载了 .inc，如果里面用了 namespace 或 class，而文件后缀不是 .php，某些 IDE 和静态分析工具（如 PHPStan）会直接跳过解析，类型提示和重构支持就断了。
