Composer怎么创建自己的PHP包_Composer自定义包开发教程【必看】-composer-PHP中文网

php包要能被packagist正确收录并安装，必须满足：顶层composer.json中name为vendor/name格式、type设为library、显式配置autoload（如psr-4）、含license字段；首次需手动提交仓库url至packagist；本地开发可用path仓库快速测试。

composer怎么创建自己的php包_composer自定义包开发教程【必看】

能直接发布到 Packagist 的 PHP 包，90% 的问题出在 composer.json 配置和自动加载规则上，而不是代码本身。

怎么写对 `composer.json` 才算“可安装”

很多人本地测试正常，一 push 到 GitHub 就被 composer require 报错“could not find package”，根本原因是 Packagist 不认你的仓库结构。

必须有顶层 composer.json，且 name 字段格式为 vendor/name（比如 myorg/http-client），不能是 http-client 或 MyOrg/HttpClient
type 建议设为 library，避免被误判为 project 或 metapackage

autoload 必须显式声明，哪怕只用 PSR-4：

{
  "autoload": {
    "psr-4": {
      "MyOrg\HttpClient\": "src/"
    }
  }
}

别漏掉 license 字段——Packagist 强制要求，填 MIT 最省事

为什么 `composer require` 找不到你的包

不是 GitHub 地址没填对，而是 Packagist 没同步或没权限抓取。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

首次提交后，必须手动去 https://www.php.cn/link/5d2e892c81e5fafc51ab0973879563a0 点 “Submit” 提交仓库 URL，不能靠“自动发现”
确保 GitHub 仓库是公开的；私有仓库需配置 composer config --global github-oauth.github.com <token></token>
如果改过 composer.json 中的 name，旧缓存会卡住——删掉本地 vendor/ 和 composer.lock，再 composer clear-cache
错误信息里出现 Could not parse version constraint，大概率是 version 字段写死了（如 "version": "1.0.0"），应删掉该字段，靠 Git tag 控制版本

本地开发时怎么边写边测，不发版也能 `require`

不用反复 git push → 等 Packagist 同步 → composer update，太慢。

在主项目 composer.json 的 repositories 里加本地路径：

"repositories": [
  {
    "type": "path",
    "url": "../my-http-client"
  }
]

然后 composer require myorg/http-client:dev-main（注意用分支名，不是 dev-master，除非你用的是 master 分支）
改完包代码后，只需在主项目里 composer update myorg/http-client，无需提交、打 tag
切记：这个 path 方式仅限开发，上线前必须换成 Packagist 正式源

最常被跳过的一步是验证自动加载是否真生效——composer dump-autoload -o 后，用 composer show myorg/http-client 看输出里有没有列出 autoload 路径。没有？说明 PSR-4 命名空间或目录映射对不上，这时候再查 src/ 下的文件命名和 namespace 声明。不是所有报错都写在终端里，有些只是静默失败。