从Windows Apache迁移PHP站点至Linux Apache遇大小写敏感问题求助

1. 明确mod_speling的作用边界 #

mod_speling 仅处理HTTP请求URL的大小写匹配，比如访问/About但实际文件是/about.php时，它会自动纠正路径。但CodeIgniter是单入口架构，所有请求都会被RewriteRule转发到index.php，框架内部加载控制器、模型、视图等文件时的大小写不匹配（比如代码里写$this->load->model('user_model')但实际文件是User_Model.php），属于PHP文件系统调用的问题，mod_speling完全无法干预——这才是你报错的核心原因。

2. 解决CodeIgniter框架内部的大小写问题 #

方案A：批量修正代码中的文件引用 #

Linux下PHP的include/require、框架的加载方法对文件名大小写严格敏感，你需要：

• 核对控制器、模型、视图的文件名与代码中引用的是否一致，比如CodeIgniter默认要求控制器文件名首字母大写（如Home.php对应Home控制器），若代码里写home就会报错。
• 用命令批量扫描代码中的加载语句，匹配实际文件：比如执行grep -r "load->" ./application找出所有框架加载调用，再对应application/下的文件逐一修正。

方案B：临时兼容（不推荐生产环境） #

如果暂时无法批量修改代码，可在PHP层面做兼容过渡：
在index.php开头添加以下代码，自定义文件包装器自动匹配大小写文件：

function case_insensitive_file_open($path, $mode) {
    $dir = dirname($path);
    $file = basename($path);
    $found = glob($dir . '/' . strtolower($file), GLOB_BRACE);
    if ($found) {
        return fopen($found[0], $mode);
    }
    return fopen($path, $mode);
}
stream_wrapper_register('file', 'case_insensitive_file_open');

注意：该方法会带来性能损耗，仅作临时过渡使用。

3. 让mod_speling对静态资源生效 #

如果静态资源（CSS/JS/图片）存在大小写问题，需调整.htaccess执行顺序，让mod_speling先处理再执行RewriteRule：

Options FollowSymLinks

<IfModule mod_speling.c>
 CheckCaseOnly on
 CheckSpelling on
</IfModule>

<IfModule mod_rewrite.c>
 RewriteEngine On
 # 先处理静态文件大小写
 RewriteCond %{REQUEST_FILENAME} !-f
 RewriteCond %{REQUEST_FILENAME} !-d
 # 再转发到单入口
 RewriteRule ^(.*)$ index.php?/$1 [L]
</IfModule>

<IfModule !mod_rewrite.c>
 ErrorDocument 404 /index.php
</IfModule>

同时确保Docker容器中已启用mod_speling：

• 若用官方Apache镜像，在Dockerfile中添加：

RUN a2enmod speling rewrite

• 若容器已运行，进入容器执行a2enmod speling，再重启Apache服务。

4. 验证mod_speling是否生效 #

创建一个名为TestFile.php的文件，访问/testfile.php，如果能正常返回文件内容（或自动跳转至正确路径），说明mod_speling生效；若返回404，则模块未正确启用。

内容的提问来源于stack exchange，提问作者Diego Julian Massa