composer 的 use-include-path 配置基本无效，仅在硬编码 require 未被管理的文件且 classmap 未扫描到时才可能触发兜底搜索，不影响自动加载类，也不修改 php 运行时 include_path。
Composer 默认不走 PHP 的 include_path，设 use-include-path 为 true 也没用——它只影响 require 和 include 加载未被 Composer 管理的文件，且仅在启用了 classmap 自动加载且目标文件没被扫描到时才可能触发。
为什么 use-include-path 基本无效
这个配置项早被弱化成“兜底逻辑”，不是主流加载路径。Composer 的自动加载（autoload）优先走自己的映射（PSR-4/PSR-0/classmap/files），只有当你用 require 'SomeLegacyFile.php' 这种硬编码方式、且该文件不在 Composer 管理范围内时，才会尝试按 include_path 搜索——前提是 use-include-path 开着，且 PHP 自身的 include_path 确实包含对应目录。
-
use-include-path不影响new ClassFromVendor()或use Vendor\Ns\Class的解析 - 即使设为
true，Composer 也不会把vendor/autoload.php注册进 PHP 的include_path - PHP 8.1+ 已弃用修改
include_path的运行时行为（如set_include_path()），兼容性风险上升
想让旧代码里的 require 'xxx.php' 找到文件？手动补路径更可靠
与其依赖 use-include-path，不如在 composer.json 的 autoload.files 里显式声明那些全局 require 文件，或用 autoload.classmap 扫描目录。这样既明确，又不受 include_path 变动影响。
- 把 legacy 文件放进
lib/目录，然后加："autoload": { "files": ["lib/helper.php", "lib/legacy.inc"] } - 如果是一整批，用 classmap：
"autoload": { "classmap": ["lib/"] }（执行composer dump-autoload后会生成文件路径映射） - 避免在代码里写
require $_SERVER['DOCUMENT_ROOT'].'/lib/foo.php'—— 路径硬编码 +include_path依赖 = 部署时大概率报Warning: require(): failed to open stream
composer.json 里设 use-include-path 的实际效果
它只控制 Composer 生成的 vendor/autoload.php 中是否插入一行 set_include_path() 调用。但这一行默认不生效，因为：
- Composer 5.6+ 默认禁用该行为，除非你在
composer.json显式写："config": { "use-include-path": true } - 即使开了，也只在
vendor/autoload.php初始化时调一次set_include_path()，不会覆盖你代码里后续的set_include_path() - PHP-FPM / CLI 环境下
include_path常被重置，这个设置很容易被绕过
真正要复用系统级 include_path，得在 PHP 配置层动手：改 php.ini 的 include_path，或者在 Web 服务器配置里用 php_admin_value include_path。Composer 的 use-include-path 只是个微弱的、容易被忽略的开关，别指望它扛起路径管理的活。
