CodeIgniter框架入门与实战：从安装到CRUD应用开发-代码聚汇网

CodeIgniter框架入门与实战：从安装到CRUD应用开发

聂世歆·2026-08-09·阅读 22 GEO检测（免费）

CodeIgniterPHP框架MVC架构

|难度：普通|阅读约 31 分钟

1. 为什么选择CodeIgniter框架？

作为一个从业十年的全栈开发者，我接触过各种PHP框架，但CodeIgniter始终在我的工具箱里占有一席之地。这个轻量级框架特别适合需要快速交付的中小型项目，它的学习曲线平缓到令人惊讶——我见过完全没接触过框架的PHP开发者在两天内就能用它构建出可用的后台系统。

CodeIgniter最吸引我的特点是它的"零配置"理念。还记得2015年接手一个紧急项目时，客户要求在三天内完成一个带用户管理的CMS原型。当时我直接下载了CodeIgniter 3.x版本，解压后修改了三个配置项（数据库连接、加密密钥和base_url），不到半小时就搭建好了基础环境。这种开箱即用的体验在当时的PHP生态中实属难得。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 环境准备与安装

2.1 系统要求检查

在开始之前，我们需要确保开发环境满足基本要求：

PHP版本5.6或更高（推荐7.2+）
MySQL 5.6+/MariaDB或其它支持的数据库
Apache/Nginx等Web服务器
开启mbstring和JSON扩展

注意：虽然CodeIgniter 4要求PHP 7.2+，但如果你需要维护旧项目，CodeIgniter 3.x仍然支持PHP 5.6。我建议新项目直接使用最新版本。

2.2 三种安装方式对比

方式一：Composer安装（推荐）

bash复制composer create-project codeigniter4/appstarter project-name

这是我目前最推荐的方式，因为：

自动处理依赖关系
方便后续更新
集成现代PHP开发流程

方式二：手动下载
从官网下载压缩包后解压，适合：

没有Composer环境的场景
需要快速演示的场合
受限的服务器环境

方式三：Git克隆

bash复制git clone https://github.com/codeigniter4/appstarter.git

适合需要持续跟踪开发版本的场景

3. 项目结构深度解析

安装完成后，你会看到如下目录结构（以CodeIgniter 4为例）：

code复制app/
├── Config/       # 所有配置文件
├── Controllers/  # 控制器目录
├── Database/     # 数据库迁移和种子
├── Filters/      # 过滤器
├── Helpers/      # 辅助函数
├── Language/     # 多语言文件
├── Libraries/    # 自定义类库
├── Models/       # 数据模型
├── ThirdParty/   # 第三方包
├── Views/        # 视图模板
public/           # Web根目录
    ├── css/      # 样式表
    ├── js/       # JavaScript
    ├── uploads/  # 上传目录
writable/         # 可写目录（日志、缓存等）

经验分享：我习惯在app/Config/Constants.php中定义项目全局常量，比如各种状态码、分页大小等。这样比散落在各处更易于维护。

4. 第一个CRUD应用的实现

4.1 路由配置的艺术

在app/Config/Routes.php中，我们可以定义各种路由规则。CodeIgniter提供了强大的路由功能：

php复制$routes->group('products', function($routes) {
    $routes->get('list', 'ProductController::index');
    $routes->get('show/(:num)', 'ProductController::show/$1');
    $routes->post('create', 'ProductController::create');
    $routes->put('update/(:num)', 'ProductController::update/$1');
    $routes->delete('delete/(:num)', 'ProductController::delete/$1');
});

这种分组路由方式让API设计更加清晰。我在实际项目中发现，良好的路由设计可以显著降低后期维护成本。

4.2 控制器最佳实践

创建一个基础的ProductController：

php复制<?php namespace App\Controllers;

use CodeIgniter\RESTful\ResourceController;

class ProductController extends ResourceController {
    protected $modelName = 'App\Models\ProductModel';
    protected $format = 'json';
    
    public function index() {
        $data = $this->model->findAll();
        return $this->respond($data);
    }
    
    public function show($id = null) {
        $data = $this->model->find($id);
        if(!$data) return $this->failNotFound();
        return $this->respond($data);
    }
}

使用ResourceController可以快速实现RESTful API。我特别喜欢CodeIgniter的respond()方法，它自动处理了HTTP状态码和响应格式。

4.3 模型与数据库交互

创建ProductModel：

php复制<?php namespace App\Models;

use CodeIgniter\Model;

class ProductModel extends Model {
    protected $table = 'products';
    protected $primaryKey = 'id';
    protected $allowedFields = ['name', 'price', 'description'];
    protected $returnType = 'array';
    
    protected $validationRules = [
        'name' => 'required|min_length[3]',
        'price' => 'required|numeric'
    ];
}

模型层内置的验证功能是我经常使用的特性。在实际项目中，我还会添加一些自定义方法：

php复制public function search($keyword, $limit = 10) {
    return $this->like('name', $keyword)
               ->orLike('description', $keyword)
               ->limit($limit)
               ->find();
}

4.4 视图渲染技巧

虽然现在很多项目采用前后端分离，但CodeIgniter的视图系统依然强大：

php复制// 在控制器中
return view('product/list', [
    'products' => $this->model->paginate(10),
    'pager' => $this->model->pager
]);

对应的视图文件（app/Views/product/list.php）：

php复制<?= $this->extend('layouts/main') ?>

<?= $this->section('content') ?>
<h1>产品列表</h1>
<table class="table">
    <?php foreach($products as $product): ?>
    <tr>
        <td><?= esc($product['name']) ?></td>
        <td><?= number_format($product['price'], 2) ?></td>
    </tr>
    <?php endforeach ?>
</table>
<?= $pager->links() ?>
<?= $this->endSection() ?>

避坑指南：一定要使用esc()函数对输出进行转义，这是防止XSS攻击的第一道防线。我在早期项目中曾因此吃过亏。

5. 高级特性实战

5.1 认证与授权实现

虽然CodeIgniter没有内置的认证系统，但实现起来很简单。我通常创建一个Auth过滤器：

php复制<?php namespace App\Filters;

use CodeIgniter\Filters\FilterInterface;
use CodeIgniter\HTTP\RequestInterface;
use CodeIgniter\HTTP\ResponseInterface;

class Auth implements FilterInterface {
    public function before(RequestInterface $request) {
        if(!session()->get('isLoggedIn')) {
            return redirect()->to('/login');
        }
    }
    
    public function after(RequestInterface $request, ResponseInterface $response) {
        // 可在此添加响应后处理逻辑
    }
}

然后在Config/Filters.php中注册：

php复制public $aliases = [
    'auth' => \App\Filters\Auth::class
];

public $filters = [
    'auth' => ['before' => ['product/*']]
];

5.2 高效的缓存策略

CodeIgniter支持多种缓存驱动。这是我常用的缓存模式：

php复制// 尝试从缓存获取
if(!$data = cache('product_list')) {
    // 缓存不存在，从数据库获取
    $data = $this->model->findAll();
    
    // 保存到缓存，有效期1小时
    cache()->save('product_list', $data, 3600);
}

对于高并发场景，我还会添加文件锁机制防止缓存击穿：

php复制$lockKey = 'product_list_lock';
if(!$data = cache('product_list')) {
    if(cache($lockKey) === null) {
        cache()->save($lockKey, 1, 5); // 5秒锁
        
        $data = $this->model->findAll();
        cache()->save('product_list', $data, 3600);
        
        cache()->delete($lockKey);
    } else {
        // 等待缓存生成
        sleep(1);
        return $this->index(); // 重试
    }
}

5.3 命令行工具开发

CodeIgniter强大的CLI功能常被忽视。创建一个产品导入命令：

bash复制php spark make:command ProductImporter

编辑新生成的命令文件：

php复制<?php namespace App\Commands;

use CodeIgniter\CLI\BaseCommand;

class ProductImporter extends BaseCommand {
    protected $group = 'Products';
    protected $name = 'products:import';
    protected $description = 'Import products from CSV';
    
    public function run(array $params) {
        $file = $params[0] ?? null;
        if(!$file || !file_exists($file)) {
            $this->showError('Please provide a valid CSV file');
            return;
        }
        
        // 导入逻辑
        $this->call('migrate:latest'); // 可以调用其他命令
    }
}

6. 性能优化与生产部署

6.1 环境配置调优

在生产环境的.env文件中，这些配置很关键：

code复制CI_ENVIRONMENT = production
database.default.hostname = 127.0.0.1
database.default.database = prod_db
database.default.username = secure_user
database.default.password = strong_password

重要提示：永远不要把.env文件提交到版本控制！我在.gitignore中添加：

code复制.env
writable/logs/*
writable/cache/*

6.2 自动加载优化

通过composer.json优化自动加载：

json复制{
    "autoload": {
        "psr-4": {
            "App\\": "app"
        },
        "files": [
            "app/Helpers/custom_helper.php"
        ]
    },
    "autoload-dev": {
        "psr-4": {
            "Tests\\Support\\": "tests/_support"
        }
    }
}

运行composer dump-autoload -o生成优化后的加载器。

6.3 部署流程建议

我的标准部署流程：

在服务器上创建新目录
Git克隆项目（或上传代码）
复制.env.example为.env并配置
安装依赖：composer install --no-dev
设置writable目录权限
运行数据库迁移：php spark migrate
配置Web服务器指向public目录

对于Nginx，典型配置如下：

nginx复制server {
    listen 80;
    server_name example.com;
    root /var/www/project/public;
    
    index index.php;
    
    location / {
        try_files $uri $uri/ /index.php$is_args$args;
    }
    
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php7.4-fpm.sock;
    }
    
    location ~ /\.ht {
        deny all;
    }
}

7. 常见问题与解决方案

7.1 跨域问题处理

在app/Config/Filters.php中添加CORS过滤器：

php复制public $aliases = [
    'cors' => \App\Filters\Cors::class
];

public $globals = [
    'before' => [
        'cors'
    ]
];

创建Cors过滤器：

php复制<?php namespace App\Filters;

use CodeIgniter\Filters\FilterInterface;
use CodeIgniter\HTTP\RequestInterface;
use CodeIgniter\HTTP\ResponseInterface;

class Cors implements FilterInterface {
    public function before(RequestInterface $request) {
        header('Access-Control-Allow-Origin: *');
        header('Access-Control-Allow-Headers: X-Requested-With, Content-Type, Accept, Authorization');
        header('Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS');
        
        if($request->getMethod() === 'options') {
            header('HTTP/1.1 200 OK');
            exit();
        }
    }
    
    public function after(RequestInterface $request, ResponseInterface $response) {}
}

7.2 表单验证最佳实践

除了模型中的验证规则，我推荐使用单独的验证类：

php复制<?php namespace App\Validations;

class ProductRules {
    public function validateProduct(array $data) {
        $validation = \Config\Services::validation();
        
        $validation->setRules([
            'name' => 'required|min_length[3]',
            'price' => 'required|numeric',
            'images' => 'uploaded[images]|max_size[images,1024]|is_image[images]'
        ]);
        
        if(!$validation->run($data)) {
            return $validation->getErrors();
        }
        
        return true;
    }
}

在控制器中使用：

php复制$validation = new \App\Validations\ProductRules();
if($errors = $validation->validateProduct($this->request->getPost())) {
    return $this->failValidationErrors($errors);
}

7.3 文件上传处理

安全的文件上传实现：

php复制$file = $this->request->getFile('image');
if($file->isValid() && !$file->hasMoved()) {
    $newName = $file->getRandomName();
    $file->move(WRITEPATH.'uploads', $newName);
    
    // 生成缩略图
    $image = \Config\Services::image()
        ->withFile(WRITEPATH.'uploads/'.$newName)
        ->fit(300, 300, 'center')
        ->save(WRITEPATH.'uploads/thumbs/'.$newName);
}

安全提示：一定要使用getRandomName()而不是客户端文件名，我遇到过利用特殊文件名进行目录遍历攻击的案例。

8. 扩展CodeIgniter生态系统

8.1 自定义辅助函数

创建app/Helpers/custom_helper.php：

php复制<?php
if(!function_exists('format_price')) {
    function format_price($amount) {
        return '$'.number_format($amount, 2);
    }
}

在控制器或视图中直接使用：

php复制echo format_price(19.99); // 输出: $19.99

8.2 开发可复用扩展

创建一个简单的Markdown解析器扩展：

php复制<?php namespace App\Libraries;

use Parsedown;

class Markdown {
    protected $parser;
    
    public function __construct() {
        $this->parser = new Parsedown();
    }
    
    public function parse($text) {
        return $this->parser->text($text);
    }
}

通过服务类注册：

php复制<?php namespace Config;

use CodeIgniter\Config\BaseService;
use App\Libraries\Markdown;

class Services extends BaseService {
    public static function markdown($getShared = true) {
        if($getShared) {
            return static::getSharedInstance('markdown');
        }
        
        return new Markdown();
    }
}

8.3 集成第三方包

通过Composer安装PHPMailer：

bash复制composer require phpmailer/phpmailer

创建邮件服务：

php复制<?php namespace App\Libraries;

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

class EmailService {
    protected $mailer;
    
    public function __construct() {
        $this->mailer = new PHPMailer(true);
        $this->mailer->isSMTP();
        $this->mailer->Host = env('email.host');
        $this->mailer->SMTPAuth = true;
        $this->mailer->Username = env('email.username');
        $this->mailer->Password = env('email.password');
        $this->mailer->SMTPSecure = env('email.encryption');
        $this->mailer->Port = env('email.port');
    }
    
    public function send($to, $subject, $body) {
        try {
            $this->mailer->setFrom(env('email.from.address'), env('email.from.name'));
            $this->mailer->addAddress($to);
            $this->mailer->isHTML(true);
            $this->mailer->Subject = $subject;
            $this->mailer->Body = $body;
            
            return $this->mailer->send();
        } catch(Exception $e) {
            log_message('error', 'Mailer Error: '.$this->mailer->ErrorInfo);
            return false;
        }
    }
}

在项目中使用：

php复制$email = new \App\Libraries\EmailService();
$email->send('user@example.com', 'Welcome', view('emails/welcome'));

9. 测试驱动开发实践

9.1 PHPUnit基础配置

安装PHPUnit：

bash复制composer require --dev phpunit/phpunit

创建tests/ProductTest.php：

php复制<?php namespace Tests;

use CodeIgniter\Test\CIUnitTestCase;
use App\Models\ProductModel;

class ProductTest extends CIUnitTestCase {
    protected $model;
    
    protected function setUp(): void {
        parent::setUp();
        $this->model = new ProductModel();
    }
    
    public function testProductCreation() {
        $data = [
            'name' => 'Test Product',
            'price' => 9.99
        ];
        
        $id = $this->model->insert($data);
        $this->assertIsInt($id);
        
        $product = $this->model->find($id);
        $this->assertEquals('Test Product', $product['name']);
    }
}

9.2 数据库测试策略

使用CodeIgniter的测试特性：

php复制public function testProductUpdate() {
    $this->model->insert(['name' => 'Old Name', 'price' => 10]);
    
    $result = $this->model->where('name', 'Old Name')
                         ->set('name', 'New Name')
                         ->update();
    
    $this->assertTrue($result);
    $this->dontSeeInDatabase('products', ['name' => 'Old Name']);
    $this->seeInDatabase('products', ['name' => 'New Name']);
}

9.3 控制器测试示例

测试ProductController：

php复制<?php namespace Tests\Controllers;

use CodeIgniter\Test\ControllerTester;
use Tests\Support\TestCase;

class ProductControllerTest extends TestCase {
    use ControllerTester;
    
    public function testIndex() {
        $result = $this->controller('\App\Controllers\ProductController')
                      ->execute('index');
        
        $this->assertTrue($result->isOK());
        $this->assertJSON($result->getJSON());
    }
}

10. 从开发到生产

10.1 监控与日志

配置app/Config/Logger.php：

php复制public $threshold = 4; // 记录所有错误和警告
public $handlers = [
    'CodeIgniter\Log\Handlers\FileHandler' => [
        'path' => WRITEPATH.'logs/',
        'fileExtension' => 'log',
        'filePermissions' => 0644,
    ]
];

自定义日志消息：

php复制log_message('error', 'Product {id} not found', ['id' => 123]);
log_message('debug', 'Processing started at {time}', ['time' => date('Y-m-d H:i:s')]);

10.2 性能监控

添加基准点：

php复制$this->benchmark->mark('query_start');
// 执行数据库查询
$this->benchmark->mark('query_end');

echo $this->benchmark->elapsed_time('query_start', 'query_end');

10.3 持续集成配置

创建.github/workflows/ci.yml：

yaml复制name: CI

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
    - name: Setup PHP
      uses: shivammathur/setup-php@v2
      with:
        php-version: '7.4'
        extensions: mbstring, json
        coverage: none
    - name: Install dependencies
      run: composer install --no-progress --prefer-dist --optimize-autoloader
    - name: Run tests
      run: vendor/bin/phpunit

11. 项目升级与维护

11.1 版本升级策略

从CodeIgniter 3升级到4的主要步骤：

创建完整备份
在新目录安装CI4
逐步迁移：
- 配置文件
- 控制器
- 模型
- 视图
测试所有功能
切换生产环境

经验之谈：我曾帮客户升级过一个大型CI3项目，关键是要先建立一个兼容层，逐步替换而不是一次性重写。

11.2 长期维护建议

我的项目维护清单：

每月检查依赖更新
每季度安全审计
保持测试覆盖率在80%以上
文档随代码更新
定期备份策略验证

12. 学习资源与社区

12.1 官方资源

12.2 推荐书籍

《CodeIgniter 4 Cookbook》
《Building APIs with CodeIgniter》
《Pro PHP MVC with CodeIgniter》

12.3 视频教程

CodeIgniter 4官方教程系列
Udemy上的实战课程
YouTube上的免费教程

经过多年使用，我发现CodeIgniter特别适合那些需要快速开发但又不愿被复杂框架束缚的项目。它的简洁哲学让开发者能专注于业务逻辑而非框架本身。对于刚接触框架的PHP开发者，我总会推荐从CodeIgniter开始，因为它能帮你建立良好的MVC概念而不被各种复杂特性淹没。