README

Composerize WordPress 是一个Composer插件，可以将非Composer管理的WordPress应用程序（例如，通过tarball创建的应用程序）转换为Composer管理的WordPress应用程序。它基于 Composerize Drupal，由 Grasmash 提供。

它不适用于创建新的WordPress应用程序。

功能

composerize-wordpress 命令将执行以下操作

• 如果存在，则删除所有 composer.json 和 composer.lock 文件
• 基于 template.composer.json 在 [composer-root] 目录中生成一个新的 composer.json
  • 在 require 中添加对 pantheon-systems/wordpress-composer 的条目
  • 在 require 中为 [core-root]/wp-content/plugins 中的每个项目添加条目
    • [core-root]/wp-content/themes
    • [core-root]/wp-content/plugins
• 创建或修改 [composer-root]/.gitignore，为Composer管理的贡献项目添加条目，如 最佳实践。如果您不想遵循此实践，可以在作曲后修改 .gitignore。
• 执行 composer update 以生成 composer.lock、自动加载文件，并在正确位置安装所有依赖项。

它不会将 docroot/libraries 中的任何贡献项目添加到 composer.json 中。您必须手动将它们添加到您的 composer.json 文件中。除了 packagist 和 Wpackagist.org 包外，您还可以使用 asset packagist 中的任何包，这使得NPM包可用于Composer。

安装

composer global require rvtraveller/composerize-wordpress

用法

cd path/to/wordpress/project/repo
composer composerize-wordpress --composer-root=[repo-root] --core-root=[core-root]

[composer-root] 应该是您的项目根目录，其中包含 .git。

[core-root] 应该是WordPress根目录，其中包含 wp-load.php。

示例

# WordPress is located in a `docroot` subdirectory.
composer composerize-wordpress --composer-root=. --core-root=./docroot

# WordPress is located in a `web` subdirectory.
composer composerize-wordpress --composer-root=. --core-root=./web

# WordPress is located in a `public_html` subdirectory (cPanel compatible).
composer composerize-wordpress --composer-root=. --core-root=./public_html

# WordPress is located in the repository root, not in a subdirectory.
composer composerize-wordpress --composer-root=. --core-root=.

选项

• --composer-root：指定生成 composer.json 的项目根目录。这应该是您的Git仓库的根目录，其中包含 .git。
• --core-root：指定包含 wp-load.php 的WordPress根目录。
• --no-update：阻止在生成 composer.json 后自动运行 composer update。
• --no-gitignore：阻止修改根目录的 .gitignore 文件。
• --exact-versions：将WordPress核心和贡献项目（插件、主题）以精确版本约束要求的方式添加到 composer.json 中，而不是使用默认的破折号操作符。例如，将 wordpress/core 要求为 5.0 而不是 ^5.0。这会阻止项目被更新。这不是一个长期解决方案，但可能有助于通过减少项目更改的大小来更轻松地转换到使用Composer。