PHPの`or die()`をTypeScriptで（適切な型ナロイング付き）

時には古い方法が最善である場合もあります。

---

PHPには、TypeScriptの開発者がひそかにうらやむパターンがあります：

$config = getenv('API_KEY') or die('Missing API_KEY');

1行で、値を取得するかメッセージとともにクラッシュするか。if文もなければ、try-catchもない。ただインラインでのエラーハンドリング。

これをTypeScriptに持ち込みました。

パターン

import { DIE } from "phpdie";

const apiKey = process.env.API_KEY ?? DIE("Missing API_KEY");
// TypeScriptはapiKeyがstringであり、string | undefinedではないことを知っています

これだけです。API_KEYが未定義の場合、プログラムは「Missing API_KEY」と共にクラッシュします。存在する場合は、適切な型ナロイングで値を取得します。

これが機能する理由

魔法はnever型の戻り値にあります：

export function DIE(reason?: string | Error): never {
  if (typeof reason === "string") {
    const err = new Error(reason);
    throw err.stack;
  }
  throw reason;
}

neverはTypeScriptに「この関数は通常の方法で戻ることがない」と伝えます。コンパイラはこれを型ナロイングに使用します。

以下を書くと：

const value = possiblyUndefined ?? DIE("error");

TypeScriptは以下と考えます：

1. possiblyUndefinedが定義されている場合 → それを返す
2. possiblyUndefinedが未定義の場合 → DIE()が実行され、決して戻らない
3. したがって、この行の後、valueは定義済みの型である必要がある

もはやstring | undefinedではなく、ただのstringです。

実際の使用例

環境変数

const config = {
  apiKey: process.env.API_KEY ?? DIE("Missing API_KEY"),
  dbUrl: process.env.DATABASE_URL ?? DIE("Missing DATABASE_URL"),
  port: parseInt(process.env.PORT ?? DIE("Missing PORT")),
};
// すべてのフィールドが未定義でないことが保証されます

フェッチチェーン

const response = await fetch(url) ?? DIE("Fetch failed");
const data = await response.json() ?? DIE("Invalid JSON");
const user = data.users[0] ?? DIE("No users found");
// 各ステップがインラインで検証されます

オブジェクトアクセス

const settings = config.settings ?? DIE("Missing settings");
const theme = settings.theme ?? DIE("Missing theme");
// ネストされたif文はありません

DIESバリアント

UIアラートを表示してから停止したいですか？

import { DIES } from "phpdie";

const value = getValue() ?? DIES(alert, "Something went wrong!");
// アラートを表示してからスロー

DIESは最初に関数を呼び出してからスローします：

export function DIES(alertFn: Function, ...args: any[]): never {
  alertFn(...args);
  throw new Error("DIES", { cause: args });
}

どのアラート関数でも動作します：

• ブラウザ用のalert()
• ログ用のconsole.error()
• UIライブラリ用のtoast.error()
• モニタリング用のSentry.captureException()

比較

phpdieなし

const apiKey = process.env.API_KEY;
if (!apiKey) {
  throw new Error("Missing API_KEY");
}
// これでapiKeyはstring

const dbUrl = process.env.DATABASE_URL;
if (!dbUrl) {
  throw new Error("Missing DATABASE_URL");
}
// これでdbUrlはstring

2つの変数で8行。

phpdieあり

const apiKey = process.env.API_KEY ?? DIE("Missing API_KEY");
const dbUrl = process.env.DATABASE_URL ?? DIE("Missing DATABASE_URL");

2行。同じ型安全性。

インストール

npm install phpdie

import { DIE, DIES } from "phpdie";

使用する場合

適している用途：

• 必須の環境変数
• 設定の検証
• 早期終了のアサーション
• パイプラインスタイルのコード

不適な用途：

• 回復可能なエラー（try-catchを使用）
• ユーザー向けのエラー（適切なエラーハンドリングを使用）
• ライブラリ（消費者にエラー処理を任せる）

哲学

時には最もシンプルな解決策が最善です。

PHPのor die()パターンは何十年も存在しています。洗練されていません。「クリーンアーキテクチャ」でもありません。しかし、うまく機能します。

TypeScriptの型システムはこのパターンを型安全にするほど強力です。neverがその鍵で、コンパイラに「この分岐はここで終了する」と伝えます。

シンプルなパターンを受け入れ、型安全にし、コードをリリースしましょう。

---

試してみてください

インストール: npm install phpdie

GitHub: github.com/snomiao/phpdie

const answer = getAnswer() ?? DIE("No answer found");

---

Snowstar Miaoは時折PHPを評価しています。