support字段用于声明项目支持信息，如issues、docs、chat等，帮助开发者获取技术支持。常见子字段包括issues（问题跟踪）、docs（文档）、chat（实时交流）、source（源码）等。配置示例如：{ "support": { "issues": "https://github.com/...", "docs": "https://your-vendor.github.io/...", "chat": "https://discord.gg/...", "source": "https://github.com/..." }}。建议提供有效链接，避免泄露邮箱，提升项目可维护性与协作效率。
在 composer.json 中，support 字段用于提供项目的辅助信息，比如项目的问题跟踪地址、官方文档链接或社区支持渠道。它不参与依赖管理或自动加载，主要用于帮助使用者快速找到技术支持资源。
support 字段的作用
当你发布一个开源包或内部组件时，其他开发者可能需要报告 bug、查阅文档或寻求帮助。support 字段就是用来集中声明这些支持方式的入口，提升项目的可维护性和用户体验。
支持的子字段有哪些
Composer 官方定义了以下几个常用的子字段：
- issues：问题反馈地址（如 GitHub Issues）
- docs：项目文档链接
- chat：实时交流渠道（如 Discord、Slack）
- forum：论坛链接
- source：源码仓库地址（虽然通常用 repository 字段，但 support.source 也可用）
- email：联系邮箱（注意隐私风险）
配置示例
以下是一个典型的 composer.json 中 support 字段的写法：
{
"name": "your-vendor/your-package",
"description": "A sample PHP package",
"type": "library",
"license": "MIT",
"authors": [
{
"name": "Your Name",
"email": "you@example.com"
}
],
"require": {
"php": "^8.0"
},
"support": {
"issues": "https://github.com/your-vendor/your-package/issues",
"docs": "https://your-vendor.github.io/your-package/",
"chat": "https://discord.gg/example-channel",
"source": "https://github.com/your-vendor/your-package"
}
}
使用建议
合理填写 support 字段能提升项目的专业度和协作效率：
- 尽量提供 issues 和 docs，这是最常用的支持入口
- 如果项目有活跃的社区，加上 chat 链接有助于用户快速获得帮助
- 避免在公开项目中暴露个人邮箱，除非你愿意接收邮件咨询
- 确保所有链接有效，定期检查更新
