Composer不支持直接安装非Composer格式库，但可通过package、vcs、path三种repositories类型变通引入：package适用于无composer.json的ZIP/FTP资源并需手动补全元数据；vcs需fork后添加最小composer.json；path要求本地目录含合法composer.json，仅限开发。 autoload兼容性是关键难点，老库需显式配置autoload.files或手动require。
Composer 本身不支持直接安装非 Composer 格式的第三方库（比如只有 zip 包、纯 .php 文件、Git 仓库无 composer.json 的项目），但可以通过几种变通方式“引入”——本质是绕过 Packagist 的自动解析，手动声明包信息或接管加载逻辑。
用 package 类型在 repositories 中手动定义包
适用于你有明确的下载地址（如 GitHub Release ZIP、私有 FTP 路径）且该库没有 composer.json。你需要自己补全它的元数据。
在项目根目录的 composer.json 中添加：
{
"repositories": [
{
"type": "package",
"package": {
"name": "vendor/legacy-lib",
"version": "1.2.0",
"dist": {
"url": "https://example.com/legacy-lib-1.2.0.zip",
"type": "zip"
},
"autoload": {
"psr-4": { "Legacy\\": "src/" }
}
}
}
],
"require": {
"vendor/legacy-lib": "^1.2.0"
}
}
注意点：
-
dist.url必须可被 Composer 下载（支持http(s)、ftp、本地绝对路径如file:///path/to/lib.zip） -
autoload段必须写对，否则类找不到；如果库是传统require_once风格，得用"files": ["lib/functions.php"] - 每次改了
repositories，建议运行composer clear-cache再composer update
用 vcs 类型拉取无 composer.json 的 Git 仓库
适合目标库托管在 GitHub/GitLab，但作者没写 composer.json。Composer 能识别 Git 分支/Tag，但需要你提供最低限度的包定义。
在 composer.json 中：
{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/user/old-tool"
}
],
"require": {
"user/old-tool": "dev-main"
}
}
关键限制：
- Composer 会尝试从该仓库的根目录读取
composer.json；如果不存在，会报错Could not find package user/old-tool at any version - 解决方案：fork 该仓库，在 fork 后的版本里手动加一个最简
composer.json（只需name、autoload），再指向你的 fork 地址 - 不能直接指定某个子目录为源码路径，
composer install总是以仓库根为工作目录
用 path 类型加载本地未打包的代码
适合你在本地调试一个尚未发布、甚至没建 Git 仓库的第三方库，或者想临时替换某个依赖的实际代码路径。
例如把 ./libs/my-legacy-lib 当作一个包引入：
{
"repositories": [
{
"type": "path",
"url": "./libs/my-legacy-lib"
}
],
"require": {
"mycompany/legacy-lib": "*"
}
}
要求：
-
./libs/my-legacy-lib目录下必须有合法的composer.json（哪怕只有{"name": "mycompany/legacy-lib"}） - 路径支持通配符，如
"./libs/*"，会扫描所有子目录下的composer.json - 开发时方便，但不能用于生产部署（路径不存在就失败），上线前务必换回正式源
真正麻烦的不是怎么加，而是 autoload 的兼容性——很多老库用 __autoload() 或全局 require，这类代码即使放进 vendor，也不会被 Composer 自动加载。你得在 autoload.files 里显式列出，或在 index.php 开头手动 require 它们的入口文件。漏掉这步，Class not found 错误几乎必然出现。
