Composer版本控制vendor目录及本地共享库的VSCode自动补全问题

1. 调整Composer配置解决绝对路径问题 #

修改项目的composer.json，给path仓库添加symlink: false配置，让Composer把共享库代码复制到本地vendor目录，而非创建绝对路径符号链接，这样自动加载器里的路径会变成相对路径，适配生产环境：

{
  "repositories": [
    {
        "type": "path",
        "url": "../shared",
        "options": {
            "symlink": false
        }
    }
  ],
  "require": {
    "my/shared": "*"
  },
  "config": {
    "preferred-install": "dist"
  }
}

执行composer install后，my/shared的代码会同步到项目的vendor/my/shared目录，自动加载逻辑完全由Composer维护，无需手动引入外部autoload文件。

2. 版本控制vendor目录的操作要点 #

直接按以下两步操作即可：

• 删除项目.gitignore里的vendor/规则（如果之前存在）
• 执行composer install后，把整个vendor目录提交到Git仓库，生产环境拉取代码后直接使用，无需再运行Composer命令

3. 搞定VSCode的代码补全 #

VSCode的PHP代码补全依赖PHP Intelephense插件，配合以下配置就能识别共享库代码：

1. 在VSCode插件商店安装PHP Intelephense
2. 在项目根目录新建.vscode/settings.json，添加包含路径配置，让插件扫描到共享库源码：

{
  "intelephense.environment.includePaths": [
    "../shared/src",
    "./vendor/my/shared/src"
  ]
}

同时配置同级的shared源码目录和vendor里的复制版本，既能在修改shared代码时实时看到补全变化，也能识别vendor里的最终依赖代码。

4. 共享库更新的同步流程 #

当shared仓库有代码更新时，按以下步骤同步到各个项目：

1. 进入同级的shared目录拉取最新代码：cd ../shared && git pull
2. 回到项目目录执行composer update my/shared，让Composer把最新代码同步到vendor
3. 提交项目的vendor目录变更到Git，生产环境拉取后完成更新

内容的提问来源于stack exchange，提问作者inf3rno