Rector项目中的Composer Vendor目录解析问题分析

问题背景

在PHP生态系统中，Rector是一个广泛使用的代码重构工具，它能够自动化地对PHP代码进行升级和重构。在使用Rector时，它需要读取Composer的依赖信息来正确分析项目结构。然而，当项目配置了非标准的vendor目录位置时，Rector会出现无法找到依赖信息的问题。

问题现象

当开发者在composer.json中通过config.vendor-dir配置项指定了自定义的vendor目录位置（而非默认的vendor目录）时，使用Rector的RectorConfigBuilder::withComposerBased方法会报错，提示找不到vendor/composer/installed.json文件。

技术原理分析

Rector内部通过InstalledPackageResolver类来解析项目依赖信息。当前实现中存在两个关键问题：

1. 硬编码路径：在InstalledPackageResolver类中，直接拼接了vendor/composer/installed.json路径，没有考虑composer.json中可能配置的自定义vendor目录位置。

2. 未解析Composer配置：在创建InstalledPackageResolver实例时，仅使用当前工作目录(getcwd())，没有读取和解析composer.json中的vendor-dir配置。

影响范围

这个问题会影响所有在composer.json中配置了非标准vendor目录位置的项目，当这些项目尝试使用Rector时，会遇到依赖解析失败的问题。

临时解决方案

目前，开发者可以通过以下方式临时解决这个问题：

1. 在项目根目录创建指向实际vendor目录的符号链接：

   ln -s httpdocs/vendor vendor
   

2. 或者暂时修改composer.json，使用默认的vendor目录位置。

预期修复方案

从技术实现角度，Rector应该：

1. 在创建InstalledPackageResolver时，首先解析composer.json文件
2. 读取config.vendor-dir配置项（如果存在）
3. 基于配置的vendor目录路径构建installed.json的完整路径
4. 如果未配置，则回退到默认的vendor目录

这种实现方式将完全遵循Composer的配置约定，提供更好的兼容性。

总结

这个问题反映了工具链中配置传递的重要性。作为PHP生态中的核心工具，Rector应该能够正确处理Composer的各种配置场景，包括非标准的目录结构。对于开发者而言，了解这个问题的存在可以帮助他们在遇到类似错误时快速定位原因并找到临时解决方案。