composer怎么配置项目名称_composer.json属性说明【基础】-composer

项目名称必须为「vendor/name」格式,如”myorg/my-awesome-package”,vendor通常为GitHub用户名或公司域名反写,name须全小写加连字符;description、type、license虽非强制但影响Packagist显示、工具识别与CI/CD流程。

项目名称写在 name 字段里,且必须是「vendor/name」格式

Composer 不接受随意命名,name 是必填字段(除非是根项目且未发布),格式强制为两段式:用户名/包名,中间用斜杠分隔。比如 "name": "myorg/my-awesome-package" 合法,"name": "my-awesome-package" 或 "name": "myorg\my-awesome-package" 都会报错或被忽略。

常见错误现象:composer install 报 Invalid package name "xxx": name must be in the format vendor/name;或者 packagist.org 拒绝提交。

  • vendor 名通常是你 GitHub 用户名、组织名,或公司域名反写(如 acme-corp)
  • name 部分不能含大写字母、空格、下划线(推荐全小写 + 连字符)
  • 本地开发时可暂用占位符如 "name": "local/test-project",但上线前需改真实标识

description、type、license 这三个字段虽非强制,但影响实际使用

没有 description,Packagist 页面显示为空白;不设 type(如 "type": "library" 或 "type": "project"),某些工具(如 Composer 自动加载器、插件管理器)无法正确识别项目用途;license 缺失会导致 packagist 标为 “unknown”,部分企业 CI/CD 流程会直接拦截。

典型配置示例:

"license": "MIT",
"description": "A lightweight config loader for PHP applications",
"type": "library"
  • type 值为 project 表示这是最终应用(如 Laravel 项目),不会被其他包 require;library 才是可复用的包
  • 多个许可证用数组:"license": ["MIT", "Apache-2.0"]
  • description 最好控制在 120 字以内,packagist 只显示前段

别把 name 和 autoload 的命名空间搞混

name 是包的全局唯一标识,用于 Composer 生态中的查找与依赖解析;而 autoload 下的 psr-4 或 classmap 定义的是 PHP 类文件如何映射到命名空间——两者无语法绑定关系,但人为保持一致能减少混乱。

夏夕资源网专注于CMS网站模板,主流语言整站网站源码下载,网站建设相关教程分享,好用的软件素材整合下载,提供一站式便捷自助服务。
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是赞助,收取费用仅维持本站的日常运营所需!
7. 如遇到加密压缩包,默认解压密码为"zy.lucklyus.top",如遇到无法解压的请联系管理员!
夏夕资源网-网站模板_免费源码_资源素材 » composer怎么配置项目名称_composer.json属性说明【基础】-composer
在线时间:12:00 - 22:00
关注微信公众号:微信公众号
站长邮箱:[email protected]
  • 运营天数: 1393+
  • 资源总数: 47989+
  • 用户总数: 1+
  • 今日更新: 0+
  • 访问次数: 4031149+
  • 本周更新: 0+
  • 最后更新: 2026-03-16

本站指数

×
  • 运营天数: 1393+
  • 资源总数: 47989+
  • 用户总数: 1+
  • 今日更新: 0+
  • 访问次数: 4031149+
  • 本周更新: 0+
  • 最后更新: 2026-03-16