搜索rbfraphael / wp-composer
由Composer管理的Wordpress
Requires
- php: >=8.2
- composer/installers: ^2.2
- johnpbloch/wordpress: ^6.5
- oscarotero/env: ^2.1
- vlucas/phpdotenv: ^5.6
- wpackagist-plugin/all-in-one-wp-security-and-firewall: ^5.3.0
- wpackagist-plugin/wordpress-seo: ^22.7
- wpackagist-plugin/wp-mail-smtp: ^4.0.1
- wpackagist-plugin/wp-optimize: ^3.3.2
- wpackagist-theme/twentytwentyfour: ^1.1
This package is auto-updated.
Last update: 2024-09-24 02:32:05 UTC
README
基于Composer的Wordpress的Git就绪版本。非常适合开发、易于部署和CI/CD配置。具有紧凑、易于理解和维护的文件结构。
0. 要求
- 您的机器上已安装PHP 7.2+
php命令在终端/cmd中启用（将PHP的路径添加到您的PATH环境变量中）
1. 安装
只需克隆此存储库，并在该文件夹中运行 php composer install。之后，跳到下一步。
2. 配置
配置过程很简单。您只需要复制并将 .env.example 重命名为 .env，然后编辑该文件，插入您站点的数据库配置、URL和盐密钥（您可以在 WordPress.org secret-key服务 或在我的 盐生成器 上生成，该生成器以 .env 格式输出）。之后，所有配置都可以通过您的网页浏览器完成，访问您站点的URL并按照常规Wordpress安装过程进行。
注意（1）：要访问Wordpress管理面板，您需要访问您站点的URL后跟 /cms/wp-admin 或 /cms/wp-login.php（例如，http://mywebsite.com/cms/wp-admin 或 http://mywebsite.com/cms/wp-login.php）。
注意（2）：如果您将 WP_HOME 环境变量设置为 "auto"，则 WP_HOME 将根据请求的域自动设置（例如，https://mywebsite.com/lorem/ipsum-dolor-sit-amet 将将 WP_HOME 设置为 "https://mywebsite.com/"）。
3. 添加插件
要添加插件，您需要编辑 composer.json 文件，将所需的插件添加到 "require" 部分，或运行 composer require wpackagist-plugin/<plugin-slug> 通过Composer要求插件。您还可以以常规方式安装插件，将它们添加到 /web/app/plugins 或通过Wordpress面板安装。通过这种方式添加的插件将被Composer和Git忽略（因为您没有将它们添加到 .gitignore），并且您无法使用Composer更新它们。所以，要小心。
注意：无法将自定义插件（不在WordPress/WPackagist存储库中的插件）添加到 composer.json 文件或通过Composer要求，否则会导致运行Composer时出错。要添加自定义插件（或您自己开发的插件），请按照步骤5中的说明进行。
4. 添加主题
添加主题的方法与添加插件相同。只需编辑 composer.json 文件，并将您的主题添加到 "require" 部分，或运行 composer require wpackagist-theme/<theme-slug> 通过Composer要求它们。此外，此模板附带 Twenty Twenty-Two 主题，因此您可以按照此示例添加您自己的主题。与插件一样，您可以通过常规方式添加新主题，将它们解压到 /web/app/themes 或通过Wordpress面板安装。以常规方式添加的主题将不会通过Composer更新或安装，但与插件不同，它们不会被从您的Git存储库中删除，并且在运行Composer时不会引起问题，因为它们没有被忽略在 .gitignore 文件中（只有 "Twenty something" 主题被忽略）。
注意：自定义主题（不在Wordpress/WPackagist仓库中的主题）不能添加到composer.json文件中，否则在运行Composer时会出错。
5. 添加或开发自定义插件
在某个时刻，您可能需要添加或创建自定义插件。由于这个模板使用Composer管理位于Wordpress仓库中的插件，自定义插件在使用Composer时将无法正常工作。要添加自定义插件，您需要将它们添加到您的.gitignore文件中，并确保自定义插件不在您的composer.json文件中。
6. 建站和部署
部署您的Wordpress应用程序后，您需要将您的web服务器（Apache、NGINX等）的根路径指向应用程序的web目录。
7. 环境版本控制
虽然不推荐这样做，但您可以对开发、测试和生产环境进行版本控制。为此，您只需编辑位于/config/environments/<environment>.php的相应文件，所有在.env文件中设置的设置将被相应环境脚本中的设置覆盖。
8. 语言
要将语言添加到您的Wordpress中，您需要从wp-languages.github.io仓库中获取所需的语言。例如，要安装巴西葡萄牙语（代码名为"pt_br"），请在项目根目录中运行composer require koodimonni-language/pt_br，或将koodimonni-language/pt_br: "*"添加到composer.json文件中的require部分。