CodeIgniter4中base_url()生成的URL丢失www前缀如何解决

核心原因 #

• CodeIgniter 4的配置逻辑和旧版CI3完全不同，你使用的$config['base_url']是CI3的数组配置形式，CI4不会加载这类配置，自然不会生效。CI4的基础URL配置是app/Config/App.php文件内的类属性$baseURL。
• 部分服务器、CDN、反向代理规则会提前把请求里的www前缀去掉，导致$_SERVER['HTTP_HOST']直接拿到不带www的域名。
• 若开启了配置缓存、域名重写类过滤器、服务器301跳转规则，会覆盖你在PHP代码中定义的base_url值。

操作步骤 #

1. 修正动态配置代码
   打开app/Config/App.php，找到默认的public $baseURL = 'http://localhost:8080/';配置项，替换为以下动态判断代码：

// 兼容反向代理/CDN场景的HTTPS判断
$isHttps = (
    (isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] === 'on')
    || (isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https')
);
$protocol = $isHttps ? 'https' : 'http';

$httpHost = $_SERVER['HTTP_HOST'] ?? '';
// 如需强制所有生成的URL带www前缀，取消下方代码注释即可（兼容PHP7.4+）
// if (substr($httpHost, 0, 4) !== 'www.') {
//     $httpHost = 'www.' . ltrim($httpHost, '.');
// }

$scriptPath = str_replace(basename($_SERVER['SCRIPT_NAME']), '', $_SERVER['SCRIPT_NAME']);
// CI4要求baseURL末尾必须携带斜杠
public $baseURL = rtrim($protocol . '://' . $httpHost . $scriptPath, '/') . '/';

2. 排查覆盖配置的规则

• 检查Web服务器（Nginx/Apache）的重写规则，若存在将www.你的域名301跳转到不带www域名的规则，先调整规则为保留www前缀，这类规则优先级高于PHP代码，不修改的话无论怎么配PHP都不会生效。
• 若使用CDN、反向代理服务，检查控制台是否开启了“自动剥离www前缀”“规范化域名到主域”类功能，关闭对应功能。
• 检查app/Config/Filters.php中是否挂载了域名规范化、SEO优化类的自定义/第三方过滤器，调整过滤器规则保留www前缀。

3. 清除配置缓存
   删除writable/cache/目录下所有缓存文件，CI4开启配置缓存时会直接读取缓存的旧配置，不会加载你刚修改的代码，清缓存后新配置才会生效。

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