Composer怎么安装本地扩展包_Composer引用本地路径配置【干货】-composer

Composer 通过 path 仓库类型让本地 PHP 包被识别和加载，需在 composer.json 的 repositories 中配置绝对或相对路径，本地包须有合法 name 和 version，执行 composer require 安装；require 字段不支持直接写路径，必须配 repositories；options 可控 symlink 行为；Windows 启用软链需管理员权限或开发者模式；本地包 autoload 配置必须正确。

Composer 安装本地扩展包，本质是让 composer.json 能识别并加载你本地磁盘上的 PHP 包（比如还没发布到 Packagist 的私有组件、正在开发的 SDK、或需调试的第三方 fork）。关键不在“安装”，而在“怎么告诉 Composer：这个包就在这儿，别去远程拉”。

用 path 仓库类型指向本地目录

这是最常用也最稳妥的方式。Composer 不会复制文件，而是软链接（ln -s）或硬拷贝（取决于 install 时选项），保证你改本地代码，项目里立刻生效。

• 在项目的 composer.json 中添加 repositories 配置，类型设为 path
• url 值必须是绝对路径或相对于 composer.json 的相对路径（推荐用相对路径，避免换机器失效）
• 本地包自身的 composer.json 必须有合法的 name（如 "myorg/utils"）和 version（可写 "dev-main" 或 "1.0.x-dev"）
• 执行 composer require myorg/utils 即可安装——Composer 会自动匹配到你配的 path 仓库

{
  "repositories": [
    {
      "type": "path",
      "url": "./packages/my-utils"
    }
  ],
  "require": {
    "myorg/utils": "*"
  }
}

path 仓库的 options 控制链接行为

默认 Composer 对 path 包使用符号链接（Linux/macOS）或复制（Windows），但你可以显式控制：

• "options": {"symlink": false} → 强制复制，适合 Windows 开发或 CI 环境
• "options": {"symlink": true} → 显式启用软链（Linux/macOS 下默认就是 true）
• 加 "options": {"versions": {"myorg/utils": "dev-feature-x"}} 可临时覆盖本地包 composer.json 中的 version，方便测试分支

别直接用 require 指向本地路径（常见错误）

有人尝试这样写："myorg/utils": "./packages/my-utils" —— 这是错的。Composer 的 require 字段只接受 vendor/name:version 格式，不支持路径值。这么写会导致：