如何将一个本地项目转换成一个可被 Composer 安装的包？

将本地项目变为Composer可安装包的核心是符合规范并支持自动加载：1. 创建含name、type、autoload等字段的composer.json；2. 按PSR-4组织代码结构并测试自动加载；3. 通过path仓库在其他项目中软链接引用；4. 发布到Packagist仅为可选步骤。

把本地项目变成 Composer 可安装的包，核心是让它符合 Composer 的包规范，并能被其他项目通过 composer require 正确加载。关键不在于“发布到 Packagist”，而是先让本地项目具备可发现、可自动加载、可版本管理的能力。

1. 确保项目有合法的 composer.json

根目录下必须有 composer.json，内容至少包含：

• name：格式为 vendor/name（如 myorg/my-package），不能只写 my-package
• type：建议设为 library（除非是插件或框架扩展）
• autoload：定义类如何自动加载，常用 PSR-4（推荐）或 classmap
• version（可选但建议）：如果暂不发版，可先设为 "dev-main" 或 "dev-master"

示例最小配置：

{
  "name": "acme/utils",
  "type": "library",
  "autoload": {
    "psr-4": {
      "Acme\Utils\": "src/"
    }
  },
  "require": {}
}

2. 规范代码结构并测试自动加载

按 autoload 中的映射组织文件。比如上面的 PSR-4 配置要求：

• 所有类命名空间以 AcmeUtils 开头
• 对应文件放在 src/ 下，路径与命名空间子级一致（如 AcmeUtilsHelper → src/Helper.php）

运行 composer dump-autoload 测试是否能正常生成自动加载规则，再用一个简单脚本验证类能否被 new 出来。

3. 在其他项目中临时引用本地包

无需发布，就能立即测试安装效果。在目标项目的 composer.json 中添加：

标签： composer php 包 php js git json github ai gitlab