可直接在旧项目引入现代PHP组件，只需在真实入口文件顶部加载vendor/autoload.php、用classmap映射旧类、用files加载全局函数/常量，新旧代码并存且无需修改老逻辑。
可以直接在旧项目里引入现代PHP组件，不用改老代码、不破坏现有流程，关键是“局部加载”——只让新组件走 Composer，老逻辑照常运行。
为什么不能直接 require vendor/autoload.php 到每个文件里
老项目通常有多个入口（index.php、admin.php、CLI 脚本），但也有大量中间层文件（如 config.php、functions.php）会反复被 include。如果在这些非入口文件里加 require_once 'vendor/autoload.php'：
- 可能触发多次加载，导致
Fatal error: Cannot redeclare class - 若老代码已有
__autoload()或spl_autoload_register()，会和 Composer 加载器冲突 -
config.php里若有define()或exit，提前执行会中断 CLI 命令或测试
正确做法：只在真实入口文件最顶部加这一行，且确保它在任何老加载逻辑之前。
classmap 是旧类的唯一可靠加载方式
老项目类没命名空间、文件名不规范（比如 Db.php 里定义 class Database）、目录分散（lib/、includes/、models/）——这时 PSR-4 会彻底失效，Class 'Database' not found 是必然结果。
立即学习“PHP免费学习笔记（深入）”；
必须用 classmap：
- 在
composer.json中写："autoload": { "classmap": ["lib/", "includes/", "models/"] } - 路径必须是相对于
composer.json的，别写./lib/或绝对路径 - 执行
composer dump-autoload后，所有.php文件里的class、interface、trait都会被扫描进静态映射表 - 老代码中继续用
new Database()，完全不用改
注意：如果老代码已手动 require_once 'lib/Database.php'，这行必须删掉，否则类重复定义。
files 字段专治全局函数和常量
老项目常见 helper.php 里一堆 function str_clean()，或 constants.php 里 define('SITE_URL', ...) ——这类没法走 classmap，也不能塞进 PSR-4。
用 files 字段：
- 配置示例：
"autoload": { "files": ["lib/helper.php", "config/constants.php"] } - 这些文件会在
vendor/autoload.php初始化时require_once一次，且仅一次 - 适合放纯函数、常量、配置项；千万别把含
class定义的文件放进来，否则和classmap冲突 - 路径同样必须相对
composer.json，且文件必须真实存在，否则composer install会中断
引入现代组件后怎么调用？
比如你 composer require monolog/monolog，之后就可以直接在入口文件或新写的类里用：
use Monolog\Logger;<br>use Monolog\Handler\StreamHandler;<br><br>$logger = new Logger('name');<br>$logger->pushHandler(new StreamHandler('php://stdout'));<br>$logger->info('Hello');
但注意两点：
- 老代码里仍可继续用
echo或自定义log_msg()，新旧日志逻辑可并存 - 如果你在老类里想用
Logger，得先确保该老类是通过classmap加载的（不是手动require），否则命名空间解析会失败
真正容易被忽略的是 OPcache：改了 autoload 配置、跑了 composer dump-autoload，但 PHP 还缓存着旧的 vendor/composer/autoload_classmap.php，导致新加的类还是找不到——上线前务必清理 OPcache 或重启 PHP-FPM。
