Composer不识别非标准格式库，需手动配置autoload：classmap扫描路径下所有PHP类文件，files全局加载函数文件，path仓库适配本地裸库，package仓库管理远程无composer.json的多版本项目。
Composer 本身不识别非 Composer 格式的库——不是你命令写错了，是它压根没把那些 .php 文件、ZIP 包或 Git 仓库当“包”看。集成这类库必须绕过 Packagist 的自动解析流程，靠手动补全元信息或接管加载路径。
classmap 是最轻量的类文件接入方式
适用于一堆散装类文件（如 DB.php、Utils.php）或旧目录结构（无命名空间、无标准目录映射）。它不关心文件名、不校验类名规则，只扫描路径下所有 PHP 文件里定义的类。
-
composer.json中的"autoload": { "classmap": ["lib/old/", "src/helpers.php"] }—— 路径是相对于composer.json的，支持文件和目录 - 必须运行
composer dump-autoload才会生成映射，install或update不触发这步 - 别把整个
vendor/或.git目录塞进 classmap，会拖慢生成速度，还可能引入冲突 - 如果同时用了 PSR-4，确保 classmap 路径不和 PSR-4 声明的命名空间路径重叠，否则可能报
Class already defined
files autoload 适合全局函数或单文件工具库
老旧库常含一堆 function xxx() 而非类，比如早期的 mysql_connect() 封装。这类无法用 classmap 加载（它只认 class 关键字），得靠 "autoload": { "files": ["lib/legacy/functions.php"] }。
-
files列表里的文件会在每次请求时被require_once—— 不是按需加载，而是“一启动就全拉进来” - 多个文件按数组顺序加载，注意依赖顺序：先定义函数，再调用
- 若函数名可能冲突（比如两个库都定义了
debug()），务必在文件内加if (!function_exists('debug')) { function debug() { ... } } - 别指望它支持条件加载；要动态控制，得自己封装一层入口函数
path 类型仓库 + 手动补 composer.json 是最可控的方案
当你需要把一个 ZIP 解压后目录、Git 克隆下来的裸仓库，当作“正规包”来管理（比如指定版本、参与依赖解析），就得走 path 仓库 + 补 composer.json 的路。
- 先解压 ZIP 到
./packages/my-old-sdk/，然后在该目录下新建合法的composer.json，至少包含"name"（格式为vendor/name）、"version"和"autoload" - 项目根目录
composer.json加："repositories": [{ "type": "path", "url": "./packages/my-old-sdk" }] - 运行
composer require vendor/name:dev-main（版本号必须和你写的composer.json里一致） - 关键点：这个
composer.json是你替原作者写的，它决定了 Composer 怎么加载、怎么解析依赖，不能空着autoload段
package 类型仓库适合多版本或远程 Git 无 composer.json 的场景
比如你要从 GitHub 上某个没维护 composer.json 的老项目拉 v1.2.0 和 v2.0.0 两个 tag，又不想本地存多份代码，就用 package 类型。
- 必须显式声明每个版本的
"source"（URL、type、reference），不能只写个 URL 让 Composer 自己猜 -
"autoload"必须写清楚，常见是"classmap": ["src/"]或"files": ["index.php"]，漏掉就加载失败 - name 字段必须唯一且符合
vendor/name格式，否则composer require时找不到包 - 它不校验源码是否真有那些类，只按你写的 autoload 规则去映射——写错路径，运行时才报
Class not found
真正容易被忽略的是 autoload 生效时机和加载优先级：classmap 和 files 都在 vendor/composer/autoload_*.php 里固化，改完 composer.json 后不运行 dump-autoload 就等于没改；而多个 autoload 类型共存时，顺序决定谁先抢到类名——这些细节不出错时感觉不到，一出就是 undefined class 或 cannot redeclare function，查起来特别费时间。
