PHP框架里有個(gè)怪胎：Laravel堆功能堆到臃腫，它偏要反著來(lái)。CodeIgniter 4（CI4）的代碼量只有前者的三分之一，卻在2024年 still 活著，而且活得不錯(cuò)。

這篇不講情懷，只畫地圖。讀完你會(huì)知道一個(gè)HTTP請(qǐng)求進(jìn)CI4之后，每一步被誰(shuí)處理、代碼該往哪寫。

請(qǐng)求從哪進(jìn)：入口文件與生命周期

所有請(qǐng)求先撞public/index.php，這是唯一入口。它干三件事：定義路徑常量、引入自動(dòng)加載、把控制權(quán)交給CodeIgniter核心類。核心類啟動(dòng)后，按固定順序點(diǎn)火：加載配置→初始化日志→啟動(dòng)Session→解析路由→匹配控制器→執(zhí)行過(guò)濾器→跑業(yè)務(wù)代碼→渲染視圖→返回響應(yīng)。

整個(gè)過(guò)程像工廠流水線，每個(gè)工位只干一件活。CI4把這條線暴露得很干凈，不像有些框架藏在一堆Provider和Service Container后面。

路由：從URL到控制器的匹配規(guī)則

路由文件在app/Config/Routes.php。CI4支持三種寫法：閉包直接返回、指向控制器方法、或者命名路由反向生成URL。

關(guān)鍵細(xì)節(jié)：路由按定義順序匹配，第一條命中就停。所以要把具體規(guī)則放上面，通配符放下面。RESTful資源路由用$routes->resource()一行搞定，會(huì)自動(dòng)映射到標(biāo)準(zhǔn)的index/show/create/store/edit/update/destroy七個(gè)方法。

過(guò)濾器（Filter）可以綁在路由上，比如$routes->get('admin', 'Admin::index', ['filter' => 'auth'])。這是CI4的中間件實(shí)現(xiàn)，比CI3的Hook更直觀。

控制器、模型與數(shù)據(jù)庫(kù)層

控制器在app/Controllers/，繼承BaseController就能拿到請(qǐng)求對(duì)象、響應(yīng)對(duì)象、驗(yàn)證器、Session等全套工具。CI4的控制器很薄，推薦把業(yè)務(wù)邏輯塞到Model里。

模型層有兩個(gè)選擇：Entity+Model的ORM風(fēng)格，或者直接Query Builder寫原生SQL。Query Builder的鏈?zhǔn)秸{(diào)用設(shè)計(jì)得克制，沒(méi)有Laravel Eloquent那種"魔法方法"陷阱。

數(shù)據(jù)庫(kù)配置在.env或app/Config/Database.php，支持讀寫分離。遷移（Migration）和種子（Seeder）用Spark命令行跑，下面會(huì)講。

視圖、過(guò)濾器與配置系統(tǒng)

視圖支持傳統(tǒng)PHP模板，也支持簡(jiǎn)單的布局繼承。渲染用return view('name', $data)，數(shù)據(jù)自動(dòng)轉(zhuǎn)義防XSS。

過(guò)濾器（Filter）是CI4的新東西，三個(gè)鉤子：before（路由匹配后、控制器前）、after（控制器后、視圖前）、afterView（視圖渲染后）。做權(quán)限校驗(yàn)、API簽名驗(yàn)證、響應(yīng)頭注入都很順手。

配置類在app/Config/，用屬性存配置值，支持多環(huán)境覆蓋。不像有些框架搞YAML/JSON/PHP混用，CI4就一種：PHP數(shù)組，快且可緩存。

Spark CLI：命令行工具集

Spark是CI4的內(nèi)置CLI，php spark list看全部命令。常用：make:controller生成控制器骨架，migrate跑數(shù)據(jù)庫(kù)遷移，db:seed灌測(cè)試數(shù)據(jù)，serve啟動(dòng)開(kāi)發(fā)服務(wù)器。

自定義命令很簡(jiǎn)單，繼承BaseCommand，寫好run()方法，注冊(cè)到app/Config/Commands.php。CI4的CLI和Web層共享模型和配置，不用維護(hù)兩套邏輯。

CI4的文檔里藏著一句話：「框架應(yīng)該幫你做決定，但不該替你做決定?！惯@解釋了為什么它沒(méi)有ORM關(guān)聯(lián)預(yù)加載、沒(méi)有隊(duì)列系統(tǒng)、沒(méi)有開(kāi)箱即用的API認(rèn)證——這些你按需自己接。問(wèn)題是，2024年了，你愿意為"輕量"放棄多少便利？