codeIgniter是PHP生态中一款轻量级的MVC开发框架，以运行速度快、配置简单、文档完善著称，适合快速开发中小型Web项目。它遵循MVC设计模式，将业务逻辑、数据层、视图层分离，能有效提升代码的可维护性。
环境准备与框架安装
使用codeIgniter前需要先准备运行环境，要求PHP版本不低于7.3，同时需要开启PDO、mbstring等常用扩展。安装框架有两种常见方式，一是通过Composer安装，二是在官网下载完整包手动部署。
通过Composer安装的命令如下：
composer create-project codeigniter4/appstarter my-project
手动安装时，下载压缩包后解压到Web服务器的根目录，比如Apache的htdocs目录，确保可以通过浏览器访问到框架的入口文件。
基础配置说明
框架的核心配置文件位于app/Config目录下，其中App.php是应用基础配置，主要需要修改baseURL参数，设置为项目的访问地址：
<?php
namespace Config;
use CodeIgniterConfigBaseConfig;
class App extends BaseConfig
{
// 项目基础访问地址，根据实际部署环境修改
public string $baseURL = 'http://localhost/my-project/';
// 其他默认配置可保持不动
}
如果是开发环境，还需要将env文件重命名为.env，并将CI_ENVIRONMENT设置为development，方便查看错误提示。
MVC结构开发示例
创建控制器
控制器位于app/Controllers目录，下面是一个简单的欢迎页控制器示例：
<?php
namespace AppControllers;
class Welcome extends BaseController
{
// 默认访问方法
public function index()
{
// 加载视图文件
return view('welcome_message');
}
}
创建视图
视图文件位于app/Views目录，创建welcome_message.php文件，内容如下：
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>欢迎使用codeIgniter</title>
</head>
<body>
<h1>欢迎使用codeIgniter框架</h1>
<p>这是第一个自定义视图页面</p>
</body>
</html>
创建模型
模型用于操作数据库，位于app/Models目录，下面是一个简单的用户模型示例：
<?php
namespace AppModels;
use CodeIgniterModel;
class UserModel extends Model
{
// 指定数据表名
protected $table = 'users';
// 允许批量赋值的字段
protected $allowedFields = ['username', 'email'];
}
路由配置
路由配置文件位于app/Config/Routes.php，默认路由已经配置了基础访问规则，也可以自定义路由规则：
<?php
namespace Config;
use CodeIgniterRouterRouteCollection;
/**
* @var RouteCollection $routes
*/
$routes->get('/', 'Welcome::index'); // 根路径访问Welcome控制器的index方法
$routes->get('user/(:num)', 'UserController::show/$1'); // 带参数的路由规则
数据库操作
先配置数据库连接信息，在.env文件中设置数据库参数：
database.default.hostname = localhost database.default.database = test_db database.default.username = root database.default.password = 123456 database.default.DBDriver = MySQLi
然后在控制器中使用模型操作数据库：
<?php
namespace AppControllers;
use AppModelsUserModel;
class UserController extends BaseController
{
public function show($id)
{
$model = new UserModel();
// 查询指定ID的用户数据
$user = $model->find($id);
return view('user_detail', ['user' => $user]);
}
}
常见问题说明
- 访问页面出现404错误，首先检查路由配置是否正确，其次确认控制器和方法的命名是否符合规范
- 数据库连接失败，检查
.env中的数据库配置参数是否正确，数据库服务是否正常运行 - 视图文件加载失败，确认视图文件的路径和文件名是否正确，是否放在app/Views目录下
codeIgniterPHP框架使用MVC模式修改时间：2026-06-12 19:00:32