CI4与CI3在自动加载、URL配置、数据库连接和路由机制上存在根本差异:CI4移除autoload.php改用Autoload.php类显式注册PSR-4;废弃base_url配置,依赖App.php中$baseURL;数据库需手动初始化;路由改用面向对象方式注册,不支持CI3数组写法。

CodeIgniter 3 和 4 的 config/autoload.php 加载逻辑完全不同
CI3 把自动加载项全写在 config/autoload.php 的数组里,改完就生效;CI4 则完全移除了这个文件,改用 app/Config/Autoload.php 类来定义,且必须手动调用 $autoload->psr4() 或 $autoload->classmap() 才会注册命名空间或类映射。
常见错误现象:Class 'AppLibrariesSomeLib' not found,但文件明明存在、命名空间也对——根本原因是 CI4 没在 Autoload.php 中显式声明 PSR-4 映射。
- CI3 中修改
$autoload['libraries'] = ['session', 'email'];即可全局加载 - CI4 中要打开
app/Config/Autoload.php,在public $psr4数组里加'App\' => APPPATH,再确保类文件路径与命名空间严格匹配 - CI4 不再支持
$autoload['helper']这种全局自动加载,必须用helper('url')显式引入,或在控制器构造函数中统一调用
$config['base_url'] 在 CI4 中已废弃,硬编码会导致 URL 生成失败
CI3 允许你在 config/config.php 里直接写死 $config['base_url'] = 'https://example.com/';CI4 删除了该配置项,所有 URL 构建(如 site_url()、base_url())完全依赖 app/Config/App.php 中的 $baseURL 和服务器环境(尤其是 $_SERVER['HTTP_HOST'] 与 $_SERVER['REQUEST_URI'])。
典型问题:本地开发用 http://localhost/ci4,上线后生成的链接仍是 localhost 地址,或者出现双斜杠 //assets/css/app.css。
- CI4 必须设置
public $baseURL = 'https://example.com/';(结尾带斜杠),不能留空或写成'/' - 若部署在子目录(如
https://example.com/myapp/),需同步配置public $indexPage = 'index.php';并确保 Web 服务器重写规则把请求正确转发到public/index.php - CI4 的
base_url()会自动拼接$baseURL和传入路径,所以base_url('css/app.css')输出的是完整 URL,不是相对路径
CI3 的 $this->db 在 CI4 中默认不可用,不初始化会直接报错
CI3 中只要加载了数据库类,$this->db 就自动可用;CI4 默认不加载任何数据库实例,必须显式连接,否则调用 $this->db->table() 会抛出 Call to a member function table() on null。
这不是配置遗漏,而是设计变更:CI4 支持多数据库连接、连接池和延迟初始化,所以“懒加载”成了默认行为。
- 最简方案:在控制器构造函数中加
$this->db = ConfigDatabase::connect(); - 更推荐方式:在
app/Config/Database.php中确认默认组(defaultGroup)已正确定义,并使用model()辅助函数自动绑定 DB 实例(如$this->model(UserModel::class)) - 注意
app/Config/Database.php中的$DSN配置格式与 CI3 不同,CI4 要求完整 DSN 字符串(如mysql:host=localhost;dbname=ci4;charset=utf8mb4),不再拆分为 host/dbname/user 等独立键
路由写法从 $route['news/(:any)'] = 'news/view/$1'; 彻底转向基于类的方法注解和闭包
CI3 的 config/routes.php 是纯数组映射,支持通配符和正则;CI4 完全重构为面向对象路由系统,所有路由必须注册在 app/Config/Routes.php 的 $routes->add()、$routes->get() 等方法中,且优先级、中间件绑定、命名空间解析都依赖执行顺序和语法结构。
常见翻车点:把 CI3 的路由数组原样复制过去,结果 404,控制台还看不到任何提示。
- CI4 不识别
(:any)这类伪正则,必须写成{slug}或{id:d+} - 控制器路径必须带完整命名空间,比如
[AppControllersNews::class, 'view'],而不是'news/view' - 如果用了
$routes->setAutoRoute(true),记得关掉——它会自动扫描控制器方法并注册路由,容易和手动定义冲突,尤其在有同名方法时覆盖逻辑难排查









