README

用于安装 CakePHP 插件的 composer 安装器。

此安装器确保您的应用程序知道通过 composer 安装在 vendor/ 下的 CakePHP 插件。

使用方法

如果您的 CakePHP 应用程序尚未依赖 cakephp/plugin-installer，请在您的 CakePHP 应用程序中运行

composer require cakephp/plugin-installer:*

您自己的插件本身不需要要求 cakephp/plugin-installer。它们只需在 composer 配置中指定 type 即可。

"type": "cakephp-plugin"

多个插件路径

如果您的应用程序使用多个插件路径。除了配置应用程序设置外，您还需要更新您的 composer.json 以确保生成的 cakephp-plugins.php 文件正确。

// Define the list of plugin-paths your application uses.
"extra": {
    "plugin-paths": ["plugins", "extra_plugins"]
}

插件设置

为了使安装器正常工作，请确保您的插件的 composer 配置文件有一个适当的自动加载部分。假设您的插件命名空间是 "MyPlugin"，自动加载部分将是这样的

"autoload": {
    "psr-4": {
        "MyPlugin\\": "src"
    }
}

对于安装器的运行并非严格必要，但理想情况下，您还可以有一个 "autoload-dev" 部分用于加载测试文件。

"autoload": {
    "psr-4": {
        "MyPlugin\\": "src"
    }
},
"autoload-dev": {
    "psr-4": {
        "MyPlugin\\Test\\": "tests",
        "Cake\\Test\\" : "vendor/cakephp/cakephp/test"
    }
}

如果您的顶级命名空间是供应商名称，那么您的命名空间到路径映射将是这样的

"autoload": {
    "psr-4": {
        "MyVendor\\MyPlugin\\": "src"
    }
},
"autoload-dev": {
    "psr-4": {
        "MyVendor\\MyPlugin\\Test\\": "tests",
        "Cake\\Test\\" : "vendor/cakephp/cakephp/test"
    }
}

手动生成

如果您需要单独生成 cakephp-plugins.php，可以简单地运行 dumpautoload 命令。

composer dumpautoload

您不能与 dumpautoload 或 cakephp-plugins.php 一起使用 --no-scripts，否则不会生成。

如果您不想重新生成整个自动加载转储，您只需运行脚本即可。

composer run-script post-autoload-dump

有关详细信息，请参阅 composer 文档。