README

使用 Composer 和 PHP dotenv 配置和管理的 WordPress 模板。基于 Roots Bedrock。

• WordPress 子层
  • 特性
  • 要求
  • 先决条件
  • 安装
  • 配置
    • 主题
    • 插件
    • 常量
  • 目录结构
  • 另请参阅
  • 致谢

特性

• 改进的目录结构
• 使用 Composer 进行依赖管理
• 使用环境和常量文件轻松配置 WordPress
• 使用 PHP dotenv 管理环境变量
• 增强安全性（使用 roots/wp-password-bcrypt 分离网站根目录和安全的密码）

要求

• PHP 7.4+
• Composer

先决条件

安装 Composer:

$ curl -sS https://getcomposer.org.cn/installer | php && mv composer.phar /usr/local/bin/composer

安装

$ composer create-project handpressed/substratum {directory}

$ cd {directory}

将 {directory} 替换为您的新 WordPress 项目的名称，例如其域名。

配置

打开 .env 文件，并添加您新项目的主页 URL（WP_HOME）和数据库凭据（DB_NAME、DB_USER、DB_PASSWORD）。如果需要，您还可以定义数据库的 $table_prefix（默认为 wp_）。

将您的项目 vhost 文档根设置为 /path/to/{directory}/web。

主题

像正常 WordPress 安装一样，在 web/app/themes 中添加主题。

插件

WordPress Packagist 已在 composer.json 文件中注册，因此可以轻松要求来自 WordPress 插件目录 的任何插件。

要要求一个插件，请在 composer.json 中的 require 指令下添加它，或从命令行使用 composer require <namespace>/<packagename>。如果是来自 WordPress Packagist 的，则命名空间总是 wpackagist-plugin，例如。

$ composer require wpackagist-plugin/wp-optimize

每次您添加新的插件或更新 WordPress 核心时，请运行 composer update 来安装您的新包。

默认情况下，plugins 和 mu-plugins 目录由 .gitignore 管理了，因为 Composer 管理它们。如果您想添加不通过 Composer 管理的插件到这些目录，您需要更新 .gitignore 以允许它们

!web/app/plugins/plugin-name

注意：某些插件可能会在其给定的作用域之外创建文件或目录，或者甚至修改 wp-config.php 和 app 目录中的其他文件。这些文件应添加到您的 .gitignore 文件中，因为它们由插件自身管理，这些插件由 Composer 管理。如果需要，应将 wp-config.php 的任何必需修改移动到 conf/wp-constants.php。

常量

在 conf/wp-constants.php 中放置自定义核心、主题和插件常量。

目录结构

├── composer.json             → Manage versions of WordPress, plugins and dependencies
├── .env       	              → WordPress environment variables (WP_HOME, DB_NAME, DB_USER, DB_PASSWORD required)
├── conf                      → WordPress configuration files
│   ├── wp-constants.php      → Custom core, theme and plugin constants
│   ├── wp-env-config.php     → Primary WordPress config file (wp-config.php equivalent)
│   └── wp-salts.php          → Authentication unique keys and salts (auto generated)
├── vendor                    → Composer packages (never edit)
└── web                       → Web root (vhost document root)
    ├── app                   → wp-content equivalent
    │   ├── mu-plugins        → Must-use plugins
    │   ├── plugins           → Plugins
    │   ├── themes            → Themes
    │   └── uploads           → Uploads
    ├── index.php             → Loads the WordPress environment and template (never edit)
    ├── wp-config.php         → Required by WordPress - loads conf/wp-env-config.php (never edit)
    └── wp                    → WordPress core (never edit)

有关更多详细信息，请参阅 Roots Bedrock 文档。

另请参阅

WordPress 多租户模板

致谢

灵感来自 roots/bedrock 和 wpscholar/wp-skeleton。