CodeIgniter4.0是CodeIgniter框架的重大升级版本，在架构设计和功能特性上相比旧版本有不少调整，下面先介绍它的基础使用方法，再对比新旧版本的核心差异。
CodeIgniter4.0版本基础使用步骤
1. 环境准备与安装
CodeIgniter4.0要求PHP版本不低于7.3，同时需要开启intl、mbstring、curl等扩展。可以通过Composer快速安装框架，执行以下命令即可完成项目初始化：
composer create-project codeigniter4/appstarter my_ci4_project
安装完成后进入项目目录，将env文件复制为.env，修改其中的CI_ENVIRONMENT为development，开启开发模式方便调试。
2. 路由定义
CodeIgniter4.0的路由配置文件位于app/Config/Routes.php，基础路由定义方式如下：
<?php
// 定义GET请求的路由，访问/hello时执行Home控制器的index方法
$routes->get('hello', 'Home::index');
// 带参数的路由，{id}为动态参数
$routes->get('user/(:num)', 'User::show/$1');
3. 控制器编写
控制器文件需要放在app/Controllers目录下，并且需要声明命名空间，基础控制器示例如下：
<?php
namespace AppControllers;
use CodeIgniterController;
class Home extends Controller
{
public function index()
{
// 返回响应内容
return view('welcome_message');
}
}
4. 视图使用
视图文件放在app/Views目录下，控制器中通过view()函数加载视图，视图中可以嵌入PHP代码输出数据：
<!-- app/Views/welcome_message.php -->
<!DOCTYPE html>
<html>
<head>
<title>欢迎页面</title>
</head>
<body>
<h1>欢迎使用CodeIgniter4.0</h1>
<p>当前时间：<?= date('Y-m-d H:i:s') ?></p>
</body>
</html>
CodeIgniter新旧版本核心差异对比
CodeIgniter4.0相比3.x版本在多个核心层面做了调整，具体差异如下：
| 对比维度 | CodeIgniter3.x | CodeIgniter4.0 |
|---|---|---|
| PHP版本要求 | PHP 5.6及以上 | PHP 7.3及以上 |
| 命名空间支持 | 无命名空间，类通过前缀加载 | 全框架采用命名空间，符合PSR-4规范 |
| 目录结构 | 应用目录和框架目录混合，结构较松散 | 应用目录、框架目录、公共目录分离，结构更清晰 |
| 请求处理 | 通过全局变量获取请求数据 | 提供Request类统一处理请求数据，支持请求过滤 |
| 中间件支持 | 无原生中间件，需自定义钩子实现 | 原生支持中间件，可灵活处理请求前后逻辑 |
| 数据库操作 | 传统查询构造器，模型需继承CI_Model | 查询构造器增强，模型支持更多配置，支持实体类 |
版本选择建议
如果是新启动的项目，建议优先选择CodeIgniter4.0，它的架构更现代，功能更完善，长期维护支持更好。如果是已经稳定运行的老项目，且没有升级需求，可以继续使用3.x版本，避免不必要的迁移成本。如果需要从3.x迁移到4.0，需要重点关注命名空间调整、目录结构变化、方法兼容等问题，提前做好适配工作。
CodeIgniter4CodeIgniter3框架使用版本差异修改时间：2026-07-12 22:27:30