homepage字段仅接受带协议的合法URL字符串，如"https://example.com"，错误格式虽不报错但会导致链接失效或被Packagist忽略。
Composer 的 homepage 字段不是必填项，也不影响安装或依赖解析，它只在 Packagist 页面、composer show 输出和某些工具（如 Dependabot）中展示——写错格式不会报错，但写成无效 URL 会让链接失效。
homepage 字段支持哪些值类型
它只接受字符串，且必须是合法的 URL（含协议），常见错误是漏掉 https:// 或用了相对路径：
-
"homepage": "https://example.com"✅ 正确 -
"homepage": "example.com"❌ 点击跳转会变成当前页面下子路径 -
"homepage": "./docs"❌ 不是有效 URL，Packagist 会忽略该字段 -
"homepage": "git@github.com:user/repo.git"❌ SSH 地址不被识别为可点击链接
packagist.org 上 homepage 显示逻辑
Packagist 优先使用 homepage，但如果没填，会 fallback 到 source 或 repository 的 URL。注意：
- 如果
repository是 GitHub/GitLab，Packagist 会自动补上项目主页链接，此时homepage反而可能覆盖掉更准确的仓库页 - 若想指向文档站而非代码库，才需要显式设置
homepage，比如"homepage": "https://mylib.dev" - 修改后需手动触发 Packagist 同步（或等 webhook 推送），不会实时更新
composer.json 里怎么安全地加 homepage
直接编辑 composer.json 根对象，位置无关（但建议放在 description 下方、type 上方）：
{
"name": "vendor/package",
"description": "A useful package",
"homepage": "https://vendor.github.io/package",
"type": "library",
...
}
验证是否生效：
- 运行
composer show vendor/package | grep homepage，应输出对应 URL - 去 https://packagist.org/packages/vendor/package 页面查看右上角 “Homepage” 是否可点击
- 别用本地
composer install测试——它完全不读这个字段
真正容易被忽略的是：这个字段对 PHP 运行时零影响，但一旦写进公开包，就成为对外的第一印象链接；改错一次，下游用户点进去 404，比修复代码还难追溯是谁配的。
