CodeIgniter 3 REST API多版本部署 v2自定义路由无法访问问题排查

解决方案 #

按照优先级依次排查以下配置项即可解决问题：

• 检查Apache目录AllowOverride配置
  找到你站点的Apache虚拟主机配置文件，确认<Directory>节点对应v2目录的配置中，AllowOverride参数设置为All。如果该参数为None，你放在v2目录下的.htaccess文件不会被Apache读取，重写规则自然不生效。修改配置后需要重启Apache服务。
• 调整.htaccess重写规则适配子目录
  你当前的重写规则没有指定子目录路径，将v2目录下的.htaccess修改为以下内容：

  <IfModule mod_rewrite.c>
     RewriteEngine On
     RewriteBase /v2/
     RewriteCond %{REQUEST_FILENAME} !-f
     RewriteCond %{REQUEST_FILENAME} !-d
     RewriteRule ^(.*)$ index.php/$1 [L]
  </IfModule>
  

• 确认.htaccess文件权限
  检查v2目录下.htaccess文件的权限是否为644，确保Apache运行用户拥有该文件的读取权限，权限不足也会导致重写规则不加载。
• Nginx环境额外配置
  如果你使用的是Nginx服务器，默认不支持.htaccess文件，需要在Nginx站点配置中添加v2对应的重写规则：

  location /v2/ {
      try_files $uri $uri/ /v2/index.php?$query_string;
  }
  

  修改配置后重启Nginx服务即可。
• 校验CodeIgniter基础配置
  再次确认v2目录下/application/config/config.php的配置：
  $config['base_url'] = 'https://www.example.domain.com/v2/'; 注意结尾必须带斜杠
  $config['index_page'] = ''; 保持为空即可

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