迁移至新主机后Codeigniter 3站点异常：触发文件下载弹窗

1. Web服务器未配置PHP解析规则 #

这是最常见的原因：服务器没有将.php文件交给PHP处理器执行，而是直接把文件内容当作静态资源返回，浏览器识别为未知二进制文件，触发下载对话框。

解决步骤：

• 确认主机的PHP运行组件正常：Apache需启用mod_php或mod_fcgid，Nginx需确保php-fpm服务处于运行状态。
• 检查站点的重写规则与PHP解析配置：
  • Apache环境：确保根目录的.htaccess包含Codeigniter的标准重写规则，且服务器允许.htaccess生效（需在虚拟主机配置中设置AllowOverride All）：

    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^(.*)$ index.php/$1 [L]
    

  • Nginx环境：在站点配置的server块中添加PHP解析规则，注意替换为你主机的PHP-fpm路径：

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php7.4-fpm.sock; # 根据PHP版本调整
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
    

2. MIME类型配置错误 #

服务器返回的Content-Type头部不正确，没有标记为PHP或HTML类型，导致浏览器无法识别为网页内容。

解决步骤：

• Apache环境：在.htaccess或虚拟主机配置中添加MIME类型映射：

  AddType application/x-httpd-php .php .php5 .php4
  AddType text/html .php
  

• Nginx环境：确保fastcgi_params文件中包含CONTENT_TYPE的正确设置，或直接在PHP解析的location块中添加：

  fastcgi_param CONTENT_TYPE text/html;
  

3. PHP版本不兼容 #

Codeigniter 3的官方兼容范围是PHP 5.6至PHP 7.4，如果新主机使用PHP 8.x及以上版本，会导致核心代码解析异常，服务器无法执行PHP文件，只能返回原始内容。

解决步骤：

• 在主机控制面板（比如cPanel、Plesk）中切换PHP版本到7.4及以下的稳定版本（推荐7.4）。
• 升级Codeigniter 3到最新稳定版（3.1.13），该版本修复了部分PHP 7.4的兼容性问题。

4. 文件权限或所有者错误 #

如果index.php、核心框架文件的权限设置不当，或所有者与Web服务器运行用户不匹配，会导致服务器无法读取/执行PHP文件。

解决步骤：

• 设置文件与目录的标准权限：

  # 文件权限设为644
  chmod -R 644 /path/to/your/site/*
  # 目录权限设为755
  find /path/to/your/site -type d -exec chmod 755 {} \;
  

• 修改文件所有者为Web服务器运行用户（比如Apache用www-data，Nginx用nginx）：

  chown -R www-data:www-data /path/to/your/site
  

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