CodeIgniter本身不内置TDD支持,但可通过PHPUnit等标准工具实现TDD;关键在于隔离业务逻辑、Mock核心依赖(如CI_Input)、避免直接实例化控制器,并将数据访问抽离至可测试的独立类。

CodeIgniter 本身不内置 TDD 支持,但你可以用标准 PHP 测试工具(如 PHPUnit)配合其轻量架构做 TDD —— 关键不是“框架是否支持”,而是你能否隔离被测逻辑、绕过自动加载和路由干扰。
为什么直接在 CodeIgniter 中写测试常失败
新手常卡在第一步:运行 phpunit 时抛出 Fatal error: Class 'CI_Controller' not found 或 Undefined index: HTTP_HOST。这是因为:
• CodeIgniter 的核心类(如 CI_Controller)依赖完整启动流程(index.php 入口 + system 自动加载)
• 测试环境没走这个流程,直接 require 类文件会缺上下文
• 控制器方法往往耦合了 $this->input、$this->db 等全局服务,无法单独实例化
先让测试跑起来:最小可运行测试骨架
不碰控制器,从纯业务逻辑开始。比如你有个 CartCalculator 类,负责计算购物车折扣:
class CartCalculator
{
public function calculateTotal(array $items, float $discountRate = 0.0): float
{
$subtotal = array_sum(array_column($items, 'price'));
return $subtotal * (1 - $discountRate);
}
}
对应测试只需普通 PHPUnit 写法:
use PHPUnit\Framework\TestCase;
<p>class CartCalculatorTest extends TestCase
{
public function test_calculateTotal_with_no_discount_returns_subtotal()
{
$calc = new CartCalculator();
$items = [['price' => 100], ['price' => 50]];
$this->assertEquals(150.0, $calc->calculateTotal($items));
}</p><pre class="brush:php;toolbar:false;">public function test_calculateTotal_with_10_percent_discount()
{
$calc = new CartCalculator();
$items = [['price' => 100], ['price' => 50]];
$this->assertEquals(135.0, $calc->calculateTotal($items, 0.1));
}}
确保 phpunit.xml 配置了 bootstrap 加载自动加载器(vendor/autoload.php),就能直接运行 ./vendor/bin/phpunit tests/。
测试控制器:必须 Mock CI 核心依赖
控制器不能直接 new,得用 Mockery 或 PHPUnit 原生 mock 替换掉 $this->input、$this->session 等。例如测试一个接收 POST 参数的登录方法:
class Auth_controller extends CI_Controller
{
public function login()
{
$username = $this->input->post('username');
$password = $this->input->post('password');
<pre class="brush:php;toolbar:false;"> if (empty($username) || empty($password)) {
$this->output->set_status_header(400);
return;
}
// ... 实际验证逻辑
}}
测试时这样写:
class AuthControllerTest extends TestCase
{
public function test_login_with_empty_username_sets_400_status()
{
// 创建 controller 实例前,先 mock input
$inputMock = $this->createMock('CI_Input');
$inputMock->method('post')->willReturnMap([
['username', null],
['password', '123']
]);
<pre class="brush:php;toolbar:false;"> // 手动注入依赖(需提前设置 $this->input 可写)
$controller = new Auth_controller();
$reflection = new \ReflectionClass($controller);
$property = $reflection->getProperty('input');
$property->setAccessible(true);
$property->setValue($controller, $inputMock);
// 调用方法
$controller->login();
// 断言输出状态(需捕获 output)
$this->assertEquals(400, $controller->output->get_status());
}}
要点:
• 不依赖 CI_Controller 的构造函数初始化,手动注入 mock 对象
• 避免调用 parent::__construct(),否则会触发完整启动链
• 用 ReflectionClass 强制设置私有属性,是绕过 CI 封装的常用手段
• 不要试图测试路由或 HTTP 层 —— 那属于集成测试范畴,TDD 应聚焦单元行为
数据库操作怎么测:绝不连真实 DB
CodeIgniter 的 $this->db 是单例,强耦合。TDD 中必须抽离数据访问逻辑到独立类(如 UserRepository),再对它 mock:
- 把
$this->db->insert()这类调用移到UserRepository::create()方法里 - 控制器中只依赖
UserRepository接口,而非具体实现 - 测试控制器时,传入一个返回固定 ID 的 mock
UserRepository - 测试
UserRepository本身?用sqlite:memory:数据库做轻量集成测试,而非单元测试
硬连 MySQL 的测试会慢、不稳定、且违背 TDD “快速反馈”原则 —— 一个测试跑 2 秒,没人能坚持红-绿-重构循环。
真正卡住人的从来不是 CodeIgniter 版本或配置,而是没把“可测试性”当成设计约束。控制器越胖,测试越难;逻辑越散在 model 和 helper 里,越难隔离。TDD 在 CodeIgniter 里能走多远,取决于你愿不愿意先把胶水代码(CI_Controller、$this->db)推到边界之外。











