萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP exit() 與 die() 差異深度解析:CLI vs Web 模式、數字與字串參數行為

核心結論

die() 是 exit() 的別名,功能完全相同。 兩者皆終止腳本執行,可選擇性輸出訊息或回傳狀態碼。差異僅在於「慣用語意」與「參數型別行為」。

參數行為詳細對比

呼叫方式CLI 模式 (終端機)Web 模式 (HTTP 回應)說明
exit() / die()狀態碼 0,無輸出空白頁面,HTTP 200正常結束
exit(0) / die(0)狀態碼 0,無輸出空白頁面慣例:成功結束
exit(1) / die(1)狀態碼 1,無輸出空白頁面慣例:錯誤結束
exit('msg') / die('msg')輸出 "msg" 到 STDOUT,狀態碼 0輸出 "msg" 到瀏覽器字串參數會被輸出
exit(123) / die(123)狀態碼 123,**無輸出****空白頁面****整數參數視為狀態碼,不輸出**

為什麼 `die(123)` 網頁不顯示 123?

<?php
die(123);
// 等同於
exit(123);

PHP 內核邏輯:

  • 參數為 **整數** → 視為 **Exit Status Code** (0-254),**不輸出內容**
  • 參數為 **字串** → **輸出字串內容**,Exit Code = 0
  • 參數為 **其他型別** → 轉字串後輸出

正確輸出數字並終止

<?php
// 方法 1:轉字串
die('123');        // 輸出 123
exit((string)123); // 輸出 123

// 方法 2:先輸出再終止
echo 123;
die();             // 或 exit()

// 方法 3:JSON API 回應
header('Content-Type: application/json');
die(json_encode(['code' => 123, 'msg' => 'error']));

慣用語意區分 (團隊規範建議)

場景建議使用理由
正常結束腳本 (CLI)exit(0)符合 Unix 慣例,Shell 腳本可用 `$?` 判斷
錯誤中止 (CLI)exit(1) / exit($errCode)非零狀態碼表示失敗
Web 輸出錯誤訊息並結束die('錯誤訊息')語意「死前說句話」,易讀
Web 正常結束輸出echo $content; exit;分離輸出與終止,清晰
條件式提前返回return (函數) / exit (腳本)函數用 return,入口腳本用 exit

實戰範例:CLI 腳本標準模板

<?php
#!/usr/bin/env php
<?php

define('EXIT_OK', 0);
define('EXIT_ERROR', 1);
define('EXIT_INVALID_ARGS', 2);

$args = $argv;
array_shift($args); // 移除腳本名稱

if (empty($args)) {
    fwrite(STDERR, "Usage: php script.php \n");
    exit(EXIT_INVALID_ARGS);
}

$inputFile = $args[0];
if (!is_file($inputFile)) {
    fwrite(STDERR, "File not found: $inputFile\n");
    exit(EXIT_ERROR);
}

// 業務邏輯...
$success = processFile($inputFile);

exit($success ? EXIT_OK : EXIT_ERROR);

function processFile(string $file): bool {
    // ...
    return true;
}

實戰範例:Web API 統一錯誤處理

<?php
function apiResponse(int $code, string $message, mixed $data = null): never {
    http_response_code($code >= 400 ? $code : 200);
    header('Content-Type: application/json; charset=utf-8');
    echo json_encode([
        'code' => $code,
        'message' => $message,
        'data' => $data,
        'timestamp' => time(),
    ], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
    exit; // 或 die
}

// 使用
if (!$user) {
    apiResponse(401, '未授權');
}
if (!$validator->validate($input)) {
    apiResponse(422, '驗證失敗', $validator->errors());
}
apiResponse(200, '成功', $result);

特殊情況:FastCGI / PHP-FPM

  • `exit`/`die` 會立即終止當前請求處理
  • 已發送的 Header/Body 會保留送達客戶端
  • 註冊的 `register_shutdown_function()` **仍會執行**
  • 物件解構函數 `__destruct()` **仍會執行**
  • `fastcgi_finish_request()` 後再 `exit` 可實現「先回應、後處理」

歷史趣聞

  • PHP 3.0 引入 `die()` 作為 `exit()` 別名,模仿 Perl `die` 語意
  • Zend Engine 內部同一個函數指標 `zif_exit`
  • 文檔明確註明:die() — Equivalent to exit()

總結口訣

整數參數 = 狀態碼 (不輸出);字串參數 = 輸出內容 (狀態碼 0)。CLI 看狀態碼,Web 看輸出內容。習慣上 CLI 用 exit,Web 用 die。

copyright © 萬盛學電腦網 all rights reserved