文档教程【免费下载链接】learnxinyminutes-docsCode documentation written as code! How novel and totally my idea!项目地址https://gitcode.com/gh_mirrors/le/learnxinyminutes-docs点击查看免费下载Composer 是 PHP 生态中事实标准的依赖管理工具它让你在composer.json中声明项目依赖的库并自动完成安装、更新与自动加载的整套流程。本篇以 es/php-composer.md西班牙语版教程为骨架对照仓库中的英文原版 php-composer.md并结合 es/php.md 中关于 PHP 命名空间的讲解完整梳理从安装、日常使用、版本约束、composer.json与composer.lock的取舍到 PSR-4 自动加载的实战要点。读完本文你将能够在自己的 PHP 项目中独立完成 Composer 的初始化、依赖引入、版本锁定与生产环境优化。Composer 是什么PHP 的依赖管理器Composer 是一个用于管理 PHP 项目依赖的工具。它的核心工作模式是你声明项目依赖哪些库Composer 负责安装/更新它们并进一步生成自动加载器让项目代码可以按命名空间直接使用这些类。这一点在 es/php.md 的结尾也有呼应——该教程在“更多信息”一节中建议如果你来自一个拥有成熟包管理生态的语言可以进一步了解 Composer原文指向 http://getcomposer.org/。也就是说在本仓库的知识体系中es/php.md 负责讲解 PHP 语言本身的语法与特性类型、类、接口、Traits、命名空间等而 es/php-composer.md 则专门负责讲解 PHP 的依赖管理实战两者互为衔接。值得一提的是这份教程在仓库中拥有多个语言版本英文原版位于 php-composer.md西班牙语版 es/php-composer.md、意大利语版 it/php-composer.md、俄语版 ru/php-composer.md 以及葡萄牙语版 pt-br/php-composer.md 内容结构完全一致本文以西班牙语版为主体展开。安装 ComposerComposer 以composer.pharPHP Archive的形式分发安装本质上是下载官方安装脚本并交由 PHP 执行# 将 composer.phar 二进制文件安装到当前目录 curl -sS https://getcomposer.org/installer | php # 若采用这种方式之后需要这样调用 composer php composer.phar about # 将二进制文件安装到 ~/bin/composer # 注意请确保 ~/bin 已加入 shell 的 PATH 环境变量 curl -sS https://getcomposer.org/installer | php -- --install-dir~/bin --filenamecomposer两种方式的差别在于第一种把composer.phar放在当前目录调用时需要显式带上php composer.phar前缀第二种通过--install-dir与--filename参数把它安装到~/bin/composer只要~/bin在PATH中即可全局直接使用composer命令。Windows 用户则应当遵循官方针对 Windows 的安装说明官方文档00-intro.md的 Windows 安装章节进行安装。确认安装成功安装完成后可以用以下命令验证 Composer 是否就绪# 检查版本并列出可用选项 composer # 查看某个命令的更多帮助信息 composer help require # 检查 Composer 是否具备运行所需的各项能力以及是否为最新版本 composer diagnose composer diag # 短命令别名 # 将 Composer 二进制更新到最新版本 composer self-update composer self # 短命令别名其中diagnose别名diag会系统地检查 PHP 版本、扩展、网络连通性、缓存目录权限等运行环境是安装后第一件值得做的事self-update别名self则用于随时把 Composer 自身升级到最新版本。日常使用从 init 到 install 再到 requireComposer 将项目的依赖信息存储在composer.json中。你可以手动编辑该文件但更推荐让 Composer 替你管理它——所有修改依赖的操作都应通过命令完成避免手写出错。# 在当前目录创建一个新项目 composer init # 该命令会运行一个交互式问答询问项目的详细信息。 # 除非你要让其他项目依赖这个项目否则大部分问题留空即可。 # 如果 composer.json 已存在则下载依赖 composer install # 只下载生产环境依赖即排除开发依赖 composer install --no-dev # 为项目添加一个生产依赖 composer require guzzlehttp/guzzle # Composer 会自动查询 guzzlehttp/guzzle 的最新版本、下载它 # 并把新依赖写入 composer.json 的 require 字段。 composer require guzzlehttp/guzzle:6.0.* # Composer 会下载符合该模式的最新版本例如 6.0.2 # 并将依赖写入 composer.json 的 require 字段。 composer require --dev phpunit/phpunit:~4.5.0 # 以开发依赖的方式引入将使用满足 4.5.0 且 4.6.0 的最新版本。 composer require-dev phpunit/phpunit:^4.5.0 # 同样以开发依赖方式引入将使用满足 4.5.0 且 5.0 的最新版本。 # 查看可安装的包以及当前已安装的包 composer show # 只查看当前已安装的包 composer show --installed # 查找名称或描述中包含 mailgun 的包 composer search mailgun这里出现了一个关键区别composer install --no-dev只安装生产依赖开发依赖测试框架、代码生成器等不会进入生产环境而composer require --dev与composer require-dev两种写法等价都表示把包声明为开发依赖写入composer.json的require-dev字段。Packagist.org 是 Composer 的官方主仓库默认的包源绝大多数第三方 PHP 包都发布在那里composer search与composer require都会查询它。版本约束语法速查教程中通过三个典型示例展示了 Composer 的版本约束语法整理如下约束写法语义示例解释不写约束取该包的最新稳定版composer require guzzlehttp/guzzle自动选择最新版6.0.*通配符匹配下载符合该模式的最新版本如 6.0.2~4.5.0波浪号约束使用 4.5.0 且 4.6.0的最新版本允许补丁级更新^4.5.0插入号约束使用 4.5.0 且 5.0的最新版本允许次要版本更新关于版本匹配的完整规则Composer 官方有一篇专门讲解 Versions 的文档官方文档articles/versions.md建议在引入复杂依赖时查阅。composer.json 与 composer.lock浮动偏好与精确锁定这是 Composer 使用中最需要理解的一对概念composer.json存储项目对每个依赖的浮动版本偏好如^4.5.0这类约束以及项目的其他元信息。它是给人看的声明文件。composer.lock存储实际下载到的每个依赖的精确版本。永远不要手动编辑这个文件。两者的配合逻辑是如果把composer.lock提交进 Git 仓库那么所有开发者执行composer install时都会安装当前项目正在使用的精确版本即使某个依赖发布了新版本Composer 也只会下载 lock 文件中记录的版本。这保证了团队与 CI/CD 环境之间的依赖一致性是可复现构建的基础。# 如果想将所有依赖更新到仍符合版本偏好约束的最新版本 composer update # 如果只想更新某个特定依赖 composer update phpunit/phpunit # 如果想迁移某个包到更新的版本偏好可能需要先移除旧包及其依赖 composer remove --dev phpunit/phpunit composer require --dev phpunit/phpunit:^5.0需要特别说明的是install与update的分工composer install严格按composer.lock安装无 lock 文件时按composer.json解析并生成 lockcomposer update则重新解析composer.json的版本约束、更新依赖并改写 lock 文件。日常开发中应当有 lock 就用 install要升级依赖才用 update。自动加载器让命名空间直接可用Composer 安装依赖后会在vendor/目录下生成自动加载器。你的应用只需引入这一个文件即可通过命名空间直接实例化任何已安装包中的类require __DIR__ . /vendor/autoload.php; $mailgun new Mailgun\Mailgun(key);上面的Mailgun\Mailgun来自外部包无需任何手动require或include自动加载器会按命名空间把类映射到对应文件。这正是 Composer 相比传统手工引入文件的巨大优势。PSR-4 自动加载注册你自己的命名空间你还可以把自己的命名空间注册进自动加载器。在composer.json中添加autoload字段{ autoload: { psr-4: {Acme\\: src/} } }这表示自动加载器会把命名空间\Acme\下的所有类映射到src/目录下查找——例如\Acme\Foo\Bar对应文件src/Foo/Bar.php。这与 es/php.md 中讲解的 PHP 命名空间机制约第 700–731 行完全衔接该教程展示了如何声明namespace Mi\Namespace;、通过use引入其他命名空间、以及用use ... as设置别名而 PSR-4 正是把命名空间这一语言特性与文件目录建立起标准映射的自动加载约定。除 PSR-4 外你也可以使用 PSR-0旧的命名空间映射规范、Classmap类映射表或直接列出要包含的文件列表等方式此外还有autoload-dev字段专门用于注册仅开发环境使用的命名空间例如测试代码配合composer install --no-dev时这些命名空间不会被加载。重建自动加载器每当添加或修改autoload配置后都需要重建自动加载器composer dump-autoload composer dump # 短命令别名 # 将 PSR-0 与 PSR-4 包同时优化为以 classmap 方式加载。 # 生成过程较慢但能提升生产环境的加载性能。 composer dump-autoload --optimize --no-dev--optimize会把按命名空间规则动态查找的类预先扫描成静态的类映射表classmap省去运行时逐个目录探测的开销配合--no-dev生产环境只生成与线上依赖对应的映射这也是生产部署中推荐的组合。Composer 的缓存# Composer 会保留已下载的包以供后续项目复用。清理缓存的命令是 composer clear-cacheComposer 的缓存机制是全局的某个包一旦下载过其他项目再次使用时直接从本地缓存读取避免重复网络下载。当缓存损坏、磁盘空间紧张或需要强制重新拉取某个包时用composer clear-cache清空即可。故障排查三板斧composer diagnose composer self-update composer clear-cache当 Composer 行为异常时教程推荐按这个顺序排查先用composer diagnose检查环境PHP 版本、扩展、网络、权限再用composer self-update确保 Composer 本身是最新版很多诡异问题源于旧版本 bug最后用composer clear-cache清理可能损坏的本地包缓存。本教程尚未覆盖的主题本教程明确列出了两个暂未展开、但值得继续深入学习的方向创建并发布自己的包到 Packagist.org 或其他仓库——涉及composer.json的name、description、license等发布字段以及版本标签git tag与语义化版本管理Pre- 与 post- 脚本钩子——在 Composer 的特定事件如 install、update发生前后自动执行任务常用于构建步骤、缓存预热或自动生成代码。这两个主题分别对应 Composer 的发布与生命周期脚本能力可作为阅读完本文后的进阶路线。本仓库中的延伸资源es/php-composer.md本文主体西班牙语版 Composer 教程php-composer.md英文原版 Composer 教程内容与本文逐段对应es/php.md西班牙语版 PHP 语言教程其中命名空间namespace/use/ 别名一节与 PSR-4 自动加载直接相关约第 700–731 行it/php-composer.md、ru/php-composer.md、pt-br/php-composer.md同一教程的其他语言版本可用于对照阅读或学习对应语言README.md仓库整体说明——这是一个以代码形式书写文档的速成教程仓库所有文档均为可直接运行/执行的注释代码本教程的全部命令都可直接复制到终端实践验证。赞分享文档教程【免费下载链接】learnxinyminutes-docsCode documentation written as code! How novel and totally my idea!项目地址https://gitcode.com/gh_mirrors/le/learnxinyminutes-docs点击查看免费下载相关推荐如何构建企业级自主部署的数据可视化方案Apache ECharts架构深度解析如何构建企业级自主部署的数据可视化方案Apache ECharts架构深度解析 在数字化转型浪潮中数据可视化已成为企业决策的核心支撑技术。Apache EC数据可视化如何快速使用brand-colors5分钟掌握品牌配色技巧如何快速使用brand colors5分钟掌握品牌配色技巧 brand colors是一个强大的品牌配色集合支持sass、less、stylus和css多种UI库/组件DwarFS快速入门10分钟学会创建和挂载压缩文件系统DwarFS快速入门10分钟学会创建和挂载压缩文件系统 DwarFS是一款跨平台的高性能只读压缩文件系统支持Linux、FreeBSD、macOS和Wind创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考