CodeIgniter如何动态切换域名，有哪些配置技巧？

CodeIgniter实现动态域名替换不用改一行业务代码，核心思路是在配置文件中维护“域名→配置组”映射表，通过钩子或基类在请求启动时自动切换base_url、数据库组和视图模板。

动态域名替换到底解决什么问题

多数开发者第一次接触动态域名替换，是在多站点站群、多租户SaaS或一套代码部署到不同客户域名的场景里，传统做法是每个域名单独复制一份代码，修改config.php里的base_url和database配置，这种做法在域名数量少的时候还勉强能维护，一旦域名超过三五个,更新公共功能就成了噩梦。

加载中

2 分钟教你配置 DDNS，安装 ddns-go 配置动态域名解析，解决公网 IP 频繁变化问题

小北AI开源

3万195-

原视频地址

动态域名替换的本质，是让CodeIgniter在运行时根据当前访问的域名自动加载对应配置，同一个代码目录，访问www.example.com时走A数据库和A模板，访问shop.example.com时走B数据库和B模板，对开发者来说，代码只维护一份,部署也只需要一次。

CodeIgniter动态域名替换怎么实现？从配置映射开始

实现动态域名替换的第一步，是建立一个清晰的映射文件，在CodeIgniter里推荐单独创建application/config/domains.php，不要把所有配置堆在config.php里。

<?php
defined('BASEPATH') OR exit('No direct script access allowed');
$config['domain_map'] = array(
    'www.example.com' => array(
        'base_url' => 'https://www.example.com/',
        'database_group' => 'default',
        'template' => 'site_main',
        'cdn_url' => 'https://cdn.example.com/'
    ),
    'shop.example.com' => array(
        'base_url' => 'https://shop.example.com/',
        'database_group' => 'shop',
        'template' => 'site_shop',
        'cdn_url' => 'https://cdn.shop.example.com/'
    ),
    'm.example.com' => array(
        'base_url' => 'https://m.example.com/',
        'database_group' => 'mobile',
        'template' => 'mobile',
        'cdn_url' => 'https://cdn.m.example.com/'
    )
);

这个数组的键是访问域名，值是该域名对应的配置项。database_group指向application/config/database.php里定义的不同数据库连接组，template指向application/views/下不同的模板目录，这样规划后，每个域名拥有独立的base_url、数据库和视图层,但控制器和模型完全共享。

CodeIgniter动态域名替换和URL重写区别，一看就明白

很多人会把动态域名替换和URL重写混为一谈，URL重写关注的是路径结构，比如把/index.php/about变成/about，或者把/product?id=123变成/product/123，动态域名替换关注的是整个运行环境的切换，包括域名对应的数据库、静态资源域名、模板风格甚至支付配置。

两者可以同时使用，但解决的问题完全不同，URL重写发生在路由解析阶段，动态域名替换发生在更早的请求初始化阶段，如果你只配置了.htaccess的RewriteRule，域名换了但数据库还是原来的,数据会全部串掉。

CodeIgniter多域名部署配置方法（适合站群场景）

有了映射文件，下一步是让CodeIgniter在请求启动时读取并应用它，推荐使用钩子（Hook）机制，因为钩子在框架初始化最早阶段执行,优先级最高。

在application/config/hooks.php中启用钩子：

<?php
defined('BASEPATH') OR exit('No direct script access allowed');
$hook['pre_system'] = array(
    'class' => 'DomainSwitcher',
    'function' => 'switch_domain',
    'filename' => 'DomainSwitcher.php',
    'filepath' => 'hooks'
);

然后创建application/hooks/DomainSwitcher.php：

<?php
defined('BASEPATH') OR exit('No direct script access allowed');
class
 DomainSwitcher {
    public function switch_domain() {
        $CI =& get_instance();
        $CI->config->load('domains', TRUE);
        $domain_map = $CI->config->item('domain_map');
        $host = isset($_SERVER['HTTP_HOST']) ? $_SERVER['HTTP_HOST'] : '';
        if (isset($domain_map[$host])) {
            $conf = $domain_map[$host];
            $CI->config->set_item('base_url', $conf['base_url']);
            $CI->config->set_item('database_group', $conf['database_group']);
            $CI->config->set_item('template', $conf['template']);
            $CI->config->set_item('cdn_url', $conf['cdn_url']);
        } else {
            log_message('debug', 'Domain not mapped: ' . $host);
        }
    }
}

加载钩子后，任何控制器里调用base_url()或site_url()都会自动使用当前域名对应的值，数据库连接也会在模型实例化时切换到指定组，视图模板路径可以在MY_Controller基类里根据$this->config->item('template')动态设置，

<?php
class MY_Controller extends CI_Controller {
    public function __construct() {
        parent::__construct();
        $template = $this->config->item('template');
        if ($template) {
            $this->load->_ci_view_paths = array(APPPATH . 'views/' . $template . '/' => TRUE);
        }
    }
}

这样每个域名加载自己的视图目录，公共部分仍然通过$this->load->view('common/header')引用共享文件。

CodeIgniter动态域名替换成本高吗？免费方案实测

动态域名替换本身不产生任何额外费用，因为它只是配置文件加钩子的组合，不需要购买商业插件，也不需要修改框架核心，你只需要维护好domains.php这个映射表。

不过在多域名高并发场景下，每次请求都加载domains.php并解析数组确实会带来一点开销，解决方法是使用文件缓存或内存缓存，业内专家指出，对于绝大多数日均访问量在十万级以下的站点，这种配置加载的耗时几乎可以忽略不计，如果站点量级更大，可以把映射表序列化后存入APCu,钩子优先从缓存读取。

动态替换中的三个常见坑

• HTTP_HOST不可信：$_SERVER['HTTP_HOST']来自客户端请求头，理论上可以被伪造，如果域名映射涉及权限或支付，需要在Web服务器层（Nginx/Apache）做域名白名单校验。
• 数据库连接切换延迟：CodeIgniter的数据库连接是惰性加载，只有在第一次执行查询时才建立连接，因此切换database_group后，必须确保后续查询用的是同一个连接实例,不要在构造函数里手动连接默认组。
• 缓存键未隔离：多域名共用一套缓存时，如果缓存键只包含URI而不包含域名，不同站点的数据会互相覆盖,应当在缓存键前加上域名前缀。

Q&A：关于CodeIgniter动态域名替换的核心疑问

CodeIgniter动态域名替换适合什么规模的项目？

适合所有需要一套代码服务多个域名的项目，从个人开发者的多域名博客，到企业级多租户SaaS，都可以用这套思路，项目规模越小，收益越明显,因为免去了多次部署和维护多份代码的麻烦。

CodeIgniter动态域名替换必须用钩子实现吗？

不是必须，你也可以在application/core/MY_Controller.php基类构造函数里加载映射并切换配置，但钩子执行时机更早，能覆盖到路由解析前的一些逻辑，例如自定义404处理、语言包加载等,钩子是更彻底的方案。

CodeIgniter动态域名替换会影响网站GEO吗？

动态域名替换本身不会影响GEO，前提是每个域名的内容、标题、描述和站点地图都独立配置，如果模板共用导致多个域名出现完全相同的页面内容，搜索引擎可能判定为重复内容,不同域名应当有差异化的视图和元信息。