Composer 自定义安装程序.pdfVIP

Composer ⾃定义安装程序 ⾃定义安装程序 概要 有时需要在包的安装过程中执⾏其它的动作，例如：将它安装在默认的 vendor 以外 的其它⽬录。 在这 情况下，你可以考虑创建⼀个⾃定义安装程序来处理特定的逻辑。 调⽤⾃定义安装程序 假设你的项⽬已经有了⼀个⾃定义的安装模块，那么如何根据 安装类型 正确调⽤你 包⽂件中的安装程序就成为了⼀个问题。 参见见下⼀章，如何通过指令创建⾃定义安装程序。 任何⾃定义安装程序都要通过 type 属性来识别。⼀旦被确认，它将完全覆盖默认的安 装程序，并执⾏⾃⼰的安装逻辑。 ⼀个实际⽤例： phpDocumentor 的特殊模板需要安装在 /vendor 以外的其它⽬录中。 因此他们选择 phpdocumentor-template 安装类型 并为此类型创建了⼀个插件，以便将他们的 模板发送到正确的⽬录中。 在这样⼀个模板包的例⼦中 composer .j son 将使⽤以下设置： { name: phpdocumentor/template-responsive, type: phpdocumentor-template, require: { phpdocumentor/template-installer-plugin: * } } 重要提⽰： 为了确保这个模板安装程序在安装模板包之前就已存在，模板包必须写⼊ 对此安装程序包的依赖。 创建⼀个安装程序 ⼀个⾃定义安装程序通常是以 Composer 插件的形式存在，并包含有⼀个类，它实现 了 Composer\Installer\InstallerInter ace 这个接⼜。 ⼀个基本的安装程序插件必须由3个⽂件组成： 1. 包⽂件：composer .j son 2. 插件类，例如：My\Project\Composer\Plugin.php，其中的类必须实现 Composer\Plugin\PluginInter ace 接⼜。 3. 安装程序类，例如：My\Project\Composer\Installer.php，其中的类 必须实现 Composer\Installer\InstallerInter ace 接⼜。 composer.j son 此处的包⽂件和普通资源包是相同的，但需要满⾜以下条件： 1. type 属性必须是 composer-plugin。 2. extra 属性必须包含 class 元素，它定义了插件类的名称 （包含命名空间）。 如果这个包有多个插件类，可以使⽤数组的形式进⾏定义。 实例： { name: phpdocumentor/template-installer-plugin, type: composer-plugin, license: MIT, autoload: { psr-0: {phpDocumentor\\Composer: src/} }, extra: { class: phpDocumentor\\Composer\\TemplateInstallerPlugi }, require: { composer-plugin-api: 1.0.0 } } 插件类 这个类定义了 Composer 的插件，它必须实现 Composer\Plugin\PluginInter ace 这个接⼜。它可以在 activate() ⽅法中 注册⾃定义安装程序。 这个类可以被放在任何位置、使⽤任何名字，只要能够根据 extra.class 中的定义 被⾃动加载即可。 实例： ?php namespace phpDocumentor\Composer; use Composer\Composer; use Composer\IO\IOInter ace; use Composer\Plugin\PluginInter ace; class TemplateInstallerPlugin implements PluginInter ace { public unction activate(Composer $composer, IOInter ace $io) {