Controller middleware 是綁定在控制器或其方法上用於在請(qǐng)求處理前後執(zhí)行特定邏輯的機(jī)制。 1. 它是一種在請(qǐng)求到達(dá)控制器前或後運(yùn)行的函數(shù)，用於實(shí)現(xiàn)身份驗(yàn)證、權(quán)限控制、日誌記錄等功能；2. 常見使用場(chǎng)景包括用戶認(rèn)證、權(quán)限檢查、參數(shù)處理、限流防刷等，例如Express 中通過自定義ensureAdmin 函數(shù)限制訪問；3. 在不同框架中使用方式略有差異，如Laravel 通過構(gòu)造函數(shù)綁定中間件，Express 使用app.use 或路由中指定，NestJS 則採用裝飾器方式；4. 實(shí)用建議包括合理拆分邏輯、注意中間件順序、確保調(diào)用next()、提高複用性並做好測(cè)試，從而提升項(xiàng)目結(jié)構(gòu)清晰度與維護(hù)效率。

Controller middleware 是一種在處理控制器（controller）請(qǐng)求之前或之後執(zhí)行特定邏輯的機(jī)制。它常用於Web 開發(fā)框架中，比如Laravel、Express.js 或NestJS 等。它的作用類似於“中間人”，可以在真正執(zhí)行控制器方法前做一些預(yù)處理（如身份驗(yàn)證、日誌記錄等），也可以在執(zhí)行後做一些後續(xù)操作。

1.什麼是controller middleware？

簡(jiǎn)單來說，controller middleware 就是綁定在某個(gè)控制器或其方法上的函數(shù)，這些函數(shù)會(huì)在請(qǐng)求到達(dá)控制器之前（或者之後）被調(diào)用。你可以把它理解為一道關(guān)卡，只有通過了這道關(guān)卡，請(qǐng)求才能繼續(xù)往下走。

舉個(gè)例子：你有一個(gè)用戶管理頁面，只有管理員可以訪問。這時(shí)候就可以使用middleware 來檢查用戶是否有權(quán)限。如果沒權(quán)限，就直接返回錯(cuò)誤，不讓請(qǐng)求進(jìn)入真正的控制器邏輯。

2.常見的使用場(chǎng)景

• 身份驗(yàn)證：檢查用戶是否登錄
• 權(quán)限控制：判斷用戶是否有權(quán)訪問某個(gè)資源
• 日誌記錄：記錄請(qǐng)求信息，方便調(diào)試和監(jiān)控
• 參數(shù)過濾或轉(zhuǎn)換：對(duì)請(qǐng)求參數(shù)做統(tǒng)一處理
• 限流/防刷：限制單位時(shí)間內(nèi)某個(gè)用戶的請(qǐng)求次數(shù)

例如，在Express 中你可以這樣加一個(gè)簡(jiǎn)單的middleware：

 function ensureAdmin(req, res, next) {
  if (req.user && req.user.role === 'admin') {
    next(); // 繼續(xù)執(zhí)行下一個(gè)中間件或控制器} else {
    res.status(403).send('無權(quán)限');
  }
}

然後在路由中使用它：

 app.get('/admin/dashboard', ensureAdmin, (req, res) => {
  res.send('歡迎進(jìn)入後臺(tái)');
});

3.如何在不同框架中使用？

不同框架對(duì)middleware 的實(shí)現(xiàn)方式略有不同，但基本思路是一樣的。下面是幾個(gè)常見框架的使用方式：

Laravel（PHP）

Laravel 的middleware 可以綁定到整個(gè)控制器或某個(gè)方法上。例如：

 // 在控制器構(gòu)造函數(shù)中添加中間件public function __construct()
{
    $this->middleware('auth');
}

也可以只對(duì)某些方法生效：

 $this->middleware('auth')->only(['create', 'edit']);

Express.js（Node.js）

Express 的middleware 非常靈活，既可以放在路由里，也可以寫成全局中間件。例如：

 app.use('/api', authMiddleware, apiRoutes);

NestJS（Node.js）

NestJS 使用裝飾器的方式綁定middleware，更接近面向?qū)ο蟮娘L(fēng)格：

 @UseGuards(AuthGuard)
@Controller('users')
export class UsersController {}

4.一些實(shí)用建議

• 合理拆分邏輯：不要把太多邏輯塞進(jìn)一個(gè)middleware，保持職責(zé)單一。
• 順序很重要：多個(gè)middleware 按照順序依次執(zhí)行，順序不對(duì)可能導(dǎo)致問題。
• 記得調(diào)用next() ：否則請(qǐng)求會(huì)被“卡住”。
• 復(fù)用性優(yōu)先：盡量寫出可複用的middleware，避免重複代碼。
• 測(cè)試中間件行為：特別是涉及權(quán)限控制的部分，務(wù)必做好邊界情況測(cè)試。

基本上就這些。掌握好controller middleware，能讓你的項(xiàng)目結(jié)構(gòu)更清晰、邏輯更可控，也更容易維護(hù)。

以上是什麼是控制器中間件，如何使用它們？的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！