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,**無輸出** | **空白頁面** | **整數參數視為狀態碼,不輸出** |
<?php
die(123);
// 等同於
exit(123);
PHP 內核邏輯:
<?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 |
<?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;
}
<?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);
die() — Equivalent to exit()整數參數 = 狀態碼 (不輸出);字串參數 = 輸出內容 (狀態碼 0)。CLI 看狀態碼,Web 看輸出內容。習慣上 CLI 用 exit,Web 用 die。