CodeIgniter版本配置差异处理教程

CodeIgniter 4 与 3 在核心机制上存在系统性差异：自动加载从 config/autoload.php 数组式配置转向 app/Config/Autoload.php 中显式声明 PSR-4 映射；URL 构建彻底弃用 $config['base_url']，转而依赖 App.php 中精确配置的 $baseURL 及服务器环境；数据库连接不再默认可用，必须手动初始化或通过 Model 辅助函数按需获取；路由系统全面重构为面向对象风格，摒弃数组写法，要求使用 $routes->get() 等方法注册带命名空间的控制器及结构化参数。这些变化并非简单路径调整，而是体现了 CI4“按需初始化、显式声明、边界清晰”的设计哲学——升级不是替换文件，而是重写思维模式。

CodeIgniter 3 和 4 的 config/autoload.php 加载逻辑完全不同

CI3 把自动加载项全写在 config/autoload.php 的数组里，改完就生效；CI4 则完全移除了这个文件，改用 app/Config/Autoload.php 类来定义，且必须手动调用 $autoload->psr4() 或 $autoload->classmap() 才会注册命名空间或类映射。

常见错误现象：Class 'App\Libraries\SomeLib' 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 = \Config\Database::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+}
• 控制器路径必须带完整命名空间，比如 [\App\Controllers\News::class, 'view']，而不是 'news/view'
• 如果用了 $routes->setAutoRoute(true)，记得关掉——它会自动扫描控制器方法并注册路由，容易和手动定义冲突，尤其在有同名方法时覆盖逻辑难排查

事情说清了就结束。版本切换不是改几个配置路径的事，是加载时机、作用域边界和抽象层级的重新对齐。最容易被忽略的是 CI4 的“按需初始化”原则——它不替你猜意图，每个组件都要你亲手点名。

终于介绍完啦！小伙伴们，这篇关于《CodeIgniter版本配置差异处理教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！