Composer 是 PHP 的一个依赖管理工具,它可以让你声明项目所依赖的代码库,它会帮你安装这些依赖的代码库。Composer 可以帮助开发者更快捷地开发项目,减少重复劳动,提高效率。
Composer 提供了很多命令来帮助我们管理依赖包,下面是一些常用的 Composer 命令:
1. composer install: 使用 composer.json 文件中的信息来安装所有的依赖包。 2. composer update: 更新当前项目中所有的依赖包到最新版本。 3. composer require: 在当前项目中安装一个新的依赖包。 4. composer remove: 移除当前项目中某个已安装的依赖包。 5. composer search: 搜索可用的 Composer 包。 6. composer show: 显示当前项目中已安装的所有依赖包信息。 7. composer init: 创建一个新的composer.json文件来声明你的项目所依赖的代码库。 8. composer self-update: 更新 Composer 自己到最新版本。 9. composer diagnose: 运行一些诊断来检测 Composer 的运行情况是否正常。 10.composer validate: 验证当前composer.json文件是否正确无误。
一个脚本,在 Composer 中,可以是一个 PHP 回调(定义为静态方法)或任何命令行可执行的命令。脚本对于在 Composer 运行过程中,执行一个资源包的自定义代码或包专用命令是非常有用的。
注意:只有在根包的 composer.json
中定义的脚本才会被执行。即便根包的外部依赖定义了其自身的脚本,Composer 也不会去执行这些额外的脚本。
Composer 在运行过程中将会触发以下事件:
事件名称 | 详细说明 |
---|---|
**pre-install-cmd** | 在 `install` 命令执行前触发。 |
**post-install-cmd** | 在 `install` 命令执行后触发。 |
**pre-update-cmd** | 在 `update` 命令执行前触发。 |
**post-update-cmd** | 在 `update` 命令执行后触发。 |
**pre-status-cmd** | 在 `status` 命令执行前触发。 |
**post-status-cmd** | 在 `status` 命令执行后触发。 |
**pre-package-install** | 在资源包安装前触发。 |
**post-package-install** | 在资源包安装后触发。 |
**pre-package-update** | 在资源包更新前触发。 |
**post-package-update** | 在资源包更新后触发。 |
**pre-package-uninstall** | 在资源包被卸载前触发。 |
**post-package-uninstall** | 在资源包被卸载后触发。 |
**pre-autoload-dump** | 在自动加载器被转储前触发,无论是 `install`/`update` 还是 `dump-autoload` 命令都会触发。 |
**post-autoload-dump** | 在自动加载器被转储后触发,无论是 `install`/`update` 还是 `dump-autoload` 命令都会触发。 |
**post-root-package-install** | 在 `create-project` 命令期间,根包安装完成后触发。 |
**post-create-project-cmd** | 在 `create-project` 命令执行后触发。 |
archive
command is executed.post-archive-cmd: occurs after the archive
command is executed.
注意:Composer 不会去执行任何依赖包中定义的 install
或 update
相关脚本。因此你不应该在依赖包中申明 pre-update-cmd
或 pre-install-cmd
。如果你需要在执行 install
或 update
命令前使用脚本,请确保它们已被定义在根包中。
在 composer.json
的根 JSON 对象中应该有一个名为 "scripts"
的属性,它包含有一系列的事件名称,以及对应的事件脚本。一个事件的脚本可以被定义为一个字符串(仅适用于单个脚本)或数组(单个或多个脚本)。
对于任何给定的事件:
脚本定义实例:
{
"scripts": {
"post-update-cmd": "MyVendorMyClass::postUpdate",
"post-package-install": [
"MyVendorMyClass::postPackageInstall"
],
"post-install-cmd": [
"MyVendorMyClass::warmCache",
"phpunit -c app/"
]
}
}
使用前面定义的例子,这里的 MyVendorMyClass
类,就可以被使用来执行 PHP 的回调:
<?php
namespace MyVendor;
use ComposerScriptEvent;
class MyClass
{
public static function postUpdate(Event $event)
{
$composer = $event->getComposer();
// do stuff
}
public static function postPackageInstall(Event $event)
{
$installedPackage = $event->getOperation()->getPackage();
// do stuff
}
public static function warmCache(Event $event)
{
// make cache toasty
}
}
当一个事件被触发,Composer 的内部事件处理程序将接收一个 ComposerScriptEvent
对象,这是传递给您的 PHP 回调的第一个参数。这个 Event
对象拥有一些 getter 方法来帮助你取得当前事件的上下文:
getComposer()
: 返回当前的 ComposerComposer
对象实例。getName()
: 返回事件名称的字符串。getIO()
: 返回当前的 输入输出 流,它实现了 ComposerIOIOInterface
接口,以便在控制台中使用。如果你想手动运行事件脚本,可以使用下面的语法结构:
composer run-script [--dev] [--no-dev] script
例如 composer run-script post-install-cmd
将会运行所有 post-install-cmd 事件下定义的脚本。
刚学习 npm 的时候,官方教程在介绍 -g 参数时是这么描述的:“加上 -g 参数是全局安装,否则本地安装”。这种说话说一半的感觉...
我们在创建工程章节中学到的是如何使用 Maven 创建 Java 应用。现在我们将看到如何构建和测试这个应用。跳转到 C:/MVN 目录下,...
War 的插件继承自 Java 插件并添加了对组装 web 应用程序的 WAR 文件的支持。它禁用了 Java 插件生成默认的 JAR archive,并添加...
JaCoCo 插件目前还是孵化中状态。请务必注意,在以后的 Gradle 版本中,DSL 和其他配置可能会有所改变。JaCoCo 插件通过集成 JaC...
你可以用 Ant 来执行 Java 代码。在下面的例子中,给出的 java 类文件需要一个参数(管理员的邮箱地址),执行后将发送一封邮件...
Git是一个开源的分布式版本控制系统,用于敏捷高效地处理任何或小或大的项目。Git 是 Linus Torvalds 为了帮助管理 Linux 内核开...
常用设置如上图标注 1 所示,该区域的后缀类型文件在 IntelliJ IDEA 中将以标注 2 的方式进行打开。如上图标注 3 所示,我们可以...