如何在同一Yii2基础版代码上运行多实例并加载不同配置？

我之前帮不少人解决过Yii2多实例共享核心代码的问题，你的需求完全可以通过动态加载配置文件来实现，不用复制整个框架结构，维护起来会轻松很多。下面是具体的实现步骤：

1. 整理配置文件结构 #

首先在你的项目根目录（/var/www/html/fw/）下，为每个实例创建独立的配置目录，结构和默认的config目录保持一致：

• /var/www/html/fw/config_1/：存放实例1的配置，包含db.php、params.php、web.php
• /var/www/html/fw/config_2/：存放实例2的配置，包含db.php、params.php、web.php
• 保留原有的config目录作为默认配置（可选，当URL前缀不存在时 fallback 到这里）

每个配置目录里的文件和默认config目录的写法完全一样，比如config_1/db.php就写实例1的数据库连接信息：

// config_1/db.php
return [
    'class' => 'yii\db\Connection',
    'dsn' => 'mysql:host=localhost;dbname=db1',
    'username' => 'user1',
    'password' => 'pass1',
    'charset' => 'utf8',
];

2. 修改入口文件（web/index.php） #

所有请求都会经过web/index.php，我们在这里根据URL前缀动态选择配置文件。替换原有的入口代码为以下内容：

<?php
// 调试模式配置，生产环境可以注释掉
defined('YII_DEBUG') or define('YII_DEBUG', true);
defined('YII_ENV') or define('YII_ENV', 'dev');

require __DIR__ . '/../vendor/autoload.php';
require __DIR__ . '/../vendor/yiisoft/yii2/Yii.php';

// 解析URL前缀（比如访问http://myhost/url1/，前缀就是url1）
$requestUri = trim($_SERVER['REQUEST_URI'], '/');
$pathSegments = explode('/', $requestUri);
$configPrefix = $pathSegments[0] ?? 'default';

// 确定要加载的配置目录
$configDir = __DIR__ . '/../config_' . $configPrefix;
if (!is_dir($configDir)) {
    // 如果对应配置目录不存在，使用默认配置
    $configDir = __DIR__ . '/../config';
    $configPrefix = 'default';
}

// 加载配置（和默认入口逻辑一致，只是换了配置目录）
$config = yii\helpers\ArrayHelper::merge(
    require $configDir . '/web.php',
    require $configDir . '/params.php'
);

// 设置请求的baseUrl，确保Yii路由正确识别（比如/url1/site/index会解析为site/index动作）
$config['request']['baseUrl'] = '/' . $configPrefix;

// 创建并运行应用
(new yii\web\Application($config))->run();

3. 调整Apache配置 #

确保你的虚拟主机配置指向项目的web目录，并且允许.htaccess生效：

<VirtualHost *:80>
    ServerName myhost
    DocumentRoot /var/www/html/fw/web

    <Directory /var/www/html/fw/web>
        Options Indexes FollowSymLinks
        AllowOverride All  # 必须开启，让.htaccess生效
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/myhost_error.log
    CustomLog ${APACHE_LOG_DIR}/myhost_access.log combined
</VirtualHost>

同时确保web目录下的.htaccess保持默认的重写规则：

RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php

4. 关键注意事项 #

• 静态资源访问：因为我们设置了baseUrl，Yii生成的静态资源路径（比如@web/css/site.css）会自动带上URL前缀（比如/url1/css/site.css），而Apache会直接映射到web/css/site.css，无需额外配置。
• 缓存隔离：为了避免不同实例的缓存互相干扰，建议在每个配置的web.php中给缓存组件设置独立的前缀：

  // config_1/web.php
  'components' => [
      'cache' => [
          'class' => 'yii\caching\FileCache',
          'keyPrefix' => 'config1_', // 每个实例用不同的前缀
      ],
  ],
  

• 日志隔离：同样，每个实例可以配置独立的日志文件路径，避免日志混在一起：

  // config_1/web.php
  'components' => [
      'log' => [
          'targets' => [
              [
                  'class' => 'yii\log\FileTarget',
                  'logFile' => '@runtime/logs/config1_app.log',
              ],
          ],
      ],
  ],
  

这样设置后，访问http://myhost/url1/就会加载config_1的配置，访问http://myhost/url2/加载config_2的配置，而核心的MVC代码、框架文件完全共享，后续维护只需要修改一套核心代码即可。

内容的提问来源于stack exchange，提问作者Dunams