Codeigniter4子目录部署路由异常：误将子目录识别为控制器

问题描述 #

CI4安装在WordPress站点的子目录中（服务器目录结构：/var/www/html/ 为WordPress站点，/var/www/html/myapp 为CI4项目），访问示例URL mywebsite.com/ci4app/home/participantlogin 时，出现报错：

Controller or its method is not found: \App\Controllers\Ci4app::home

核心问题：CI错误将URL中的ci4app识别为控制器，实际应将home识别为控制器、participantlogin识别为对应方法。已尝试调整.env、配置文件、.htaccess及Apache配置，但未解决。

解决方案 #

1. 修正BaseURL配置 #

在CI4的.env文件或app/Config/App.php中，确保baseURL设置正确：

• .env配置示例：

  app.baseURL = 'https://mywebsite.com/ci4app/'
  

• 若未使用.env，修改App.php：

  public $baseURL = 'https://mywebsite.com/ci4app/';
  

2. 调整CI4的.htaccess规则 #

在CI4项目的public目录（即/var/www/html/myapp/public）下，修改.htaccess，确保正确重写URL并忽略子目录前缀：

RewriteEngine On
RewriteBase /ci4app/

# 禁止直接访问system目录
RewriteRule ^system/.*$ - [F,L]

# 静态资源直接访问，动态请求转发到index.php
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php/$1 [L]

3. 配置Apache目录规则 #

确保Apache已启用mod_rewrite模块，然后做以下配置：

• 在WordPress根目录（/var/www/html/）的.htaccess中，添加规则让ci4app路径指向CI4的public目录：

  # 优先处理CI4子目录请求，再执行WordPress规则
  RewriteRule ^ci4app/(.*)$ myapp/public/$1 [L]
  

• 或在Apache站点配置文件中添加：

  <Directory /var/www/html/myapp/public>
      AllowOverride All
      Require all granted
  </Directory>
  
  Alias /ci4app /var/www/html/myapp/public
  

4. 手动配置路由（自动路由失效时） #

若自动路由仍无法识别正确控制器，在app/Config/Routes.php中添加手动路由规则：

// 匹配ci4app下的所有控制器与方法请求
$routes->add('ci4app/(:controller)/(:method)', '$1::$2');

// 单独指定某个请求的路由（可选）
$routes->get('ci4app/home/participantlogin', 'Home::participantlogin');

5. 验证控制器命名规范 #

确保CI4的Home控制器文件位于app/Controllers/目录下，类名首字母大写：

namespace App\Controllers;

class Home extends BaseController
{
    public function participantlogin()
    {
        // 方法逻辑代码
    }
}

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