使用 Composer 管理 WordPress 多站点可实现核心、插件、主题的版本化管理。1. 初始化项目并安装 johnpbloch/wordpress 到 web/wp 目录；2. 配置 wp-config.php 启用多站点模式，选择子目录或子域名结构；3. 通过 composer/installers 将插件和主题安装至 wp-content 对应目录；4. 使用 wpackagist 插件仓库管理第三方组件；5. 分离上传文件与配置，上传目录映射到持久化存储，配置通过 .env 文件加载；6. 所有环境通过 composer install 保持依赖一致，提升部署效率与安全性。
使用 Composer 管理 WordPress 多站点网络能让你更灵活地控制核心文件、插件、主题和依赖项，同时保持版本可控和部署一致。虽然 WordPress 本身不原生支持 Composer，但通过合理的配置可以很好地集成到多站点环境中。
理解 WordPress 多站点与 Composer 的关系
WordPress 多站点（Multisite）是 WordPress 的一个功能，允许你在同一套安装中运行多个网站。Composer 是 PHP 的依赖管理工具，用来安装和更新 PHP 包。将两者结合的关键是：把 WordPress 核心、插件、主题等作为依赖项来管理，而不是手动上传或升级。
重点在于分离可变内容（如上传文件、配置）与代码库，并确保多站点的主站和子站都能正常访问共享的核心文件。
初始化项目并安装 WordPress
在项目根目录创建 composer.json 文件，并使用 johnpbloch/wordpress 这个常用的 WordPress 包：
{
"name": "your-company/wordpress-multisite",
"type": "project",
"require": {
"php": "^7.4 || ^8.0",
"johnpbloch/wordpress": "^6.5"
},
"extra": {
"wordpress-install-dir": "web/wp"
}
}
运行 composer install 后，WordPress 会被安装到 web/wp 目录。这样 web 根目录更安全，也便于部署。
配置多站点结构和文件路径
在 web/wp-config.php 中启用多站点模式。先完成常规安装，然后添加以下代码启用网络：
define('WP_ALLOW_MULTISITE', true);
登录后台后，在“工具 → 网络设置”中选择“子目录”或“子域名”模式，按提示操作。完成后，系统会要求你更新 wp-config.php 和 .htaccess（Apache）。
关键点是确保所有站点共享同一个 wp-content 目录，但你可以将其软链接或通过 Composer 管理插件和主题：
- 将 wp-content/plugins 设为 Git 忽略，用 Composer 安装公共插件
- 使用 composer/installers 支持插件和主题的自动安装路径
示例配置：
{
"require": {
"composer/installers": "^2.0",
"wpackagist-plugin/advanced-custom-fields": "^6.0",
"wpackagist-theme/twentytwentyfour": "^1.0"
},
"repositories": [
{ "type": "composer", "url": "https://wpackagist.org" }
],
"extra": {
"installer-paths": {
"web/wp-content/plugins/{$name}/": ["type:wordpress-plugin"],
"web/wp-content/themes/{$name}/": ["type:wordpress-theme"]
}
}
}
处理上传文件和配置隔离
多站点的上传文件（uploads）通常按站点 ID 存储在 wp-content/uploads/sites/{id}。这些文件不应纳入版本控制。建议：
- 将 web/wp-content/uploads 映射到持久化存储（如 NFS、S3）
- 使用环境变量配置数据库和密钥，避免硬编码
- 通过 .env 文件管理不同环境的配置（可用 vlucas/phpdotenv）
在 wp-config.php 中引入环境变量：
if (file_exists(__DIR__ . '/.env')) {
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
$dotenv->load();
}
define('DB_NAME', $_ENV['DB_NAME']);
define('DB_USER', $_ENV['DB_USER']);
// ...其他配置
基本上就这些。通过 Composer 管理 WordPress 多站点，核心是结构清晰、依赖明确、配置分离。部署时只需拉取代码、执行 composer install、配置环境变量，就能快速上线新实例。
