composer如何配置use-include-path为true_composer兼容旧式include路径【遗留】

use-include-path 在 composer 2.0+ 中已被彻底移除，不再支持；composer 不再读取或修改 php 的 include_path，所有自动加载严格遵循 psr-4/psr-0/classmap/files 规范。

use-include-path 在 Composer 2.0+ 中已被彻底移除，无法配置为 true —— 这不是遗漏或兼容开关没打开，而是设计上不再支持。

为什么 use-include-path 不再起作用

Composer 1.x 曾允许通过 composer.json 的 "config": { "use-include-path": true } 让 require 和 include 命中 PHP 的 include_path（比如加载 PEAR 风格包）。但 Composer 2.0 起废弃该行为：所有自动加载严格走 PSR-4/PSR-0/classmap/files，不再干预 PHP 原生 include_path 查找逻辑。

常见错误现象：
• 升级 Composer 后旧项目报 Warning: include(): Failed opening 'XXX.php' for inclusion
• composer dump-autoload -o 后仍无法通过 include 'SomeLegacyClass.php' 加载非 autoloaded 文件

• 这不是配置没生效，是代码路径本身已不被 Composer 管理
• PHP 的 include_path 仍存在，但 Composer 不再读取或修改它
• composer install 也不会再把 vendor 目录加进 include_path

如何让旧式 include 继续工作

必须显式恢复 include_path，且需在运行时设置（不能靠 Composer 自动注入）：

• 在入口文件（如 index.php 或 bootstrap.php）开头加：

  set_include_path(get_include_path() . PATH_SEPARATOR . __DIR__ . '/vendor');

• 若依赖的是子目录下的 legacy 包（如 vendor/pear/net_url2/Net/URL2.php），得把具体路径加进去：

  set_include_path(get_include_path() . PATH_SEPARATOR . __DIR__ . '/vendor/pear/net_url2');

• 避免用 ini_set('include_path', ...) —— 它会覆盖全局配置，可能破坏其他扩展

更安全的替代方案：用 files 自动加载器

如果那些旧文件是纯函数库（无命名空间、无类定义），优先走 Composer 原生支持的 files 加载机制，比操作 include_path 更可控：

• 在 composer.json 中声明：

  "autoload": {   "files": [     "vendor/legacy/helpers.php",     "vendor/pear/net_url2/Net/URL2.php"   ] }

• 执行 composer dump-autoload，这些文件会在每次请求时自动 require_once
• 优势：不依赖 include_path，不受 PHP 版本或 SAPI 模式影响，且能被 OPcache 缓存
• 注意：路径必须相对于 composer.json 所在目录；重复 include 会导致 fatal Error，files 自动处理去重

真正麻烦的不是配置开关，而是混用两种加载模型：一边靠 Composer autoload，一边又散落着裸 include。这类遗留代码里，include_path 往往还被多个地方动态修改过，单靠 set_include_path 容易漏掉某个分支路径。动手前先 var_dump(get_include_path()) 看清当前值，比猜配置更可靠。