フェイルファスト

基本原則

障害が発生するとすぐに検出して報告し、無効な状態がシステム全体に伝播するのを防ぎます。

1. 入力の検証

class UserRegistration {
    public function register(array $data): void {
        // Validate all inputs immediately
        $this->validateEmail($data['email']);
        $this->validatePassword($data['password']);
        $this->validateAge($data['age']);

        // Only proceed if all validations pass
        $this->createUser($data);
    }

    private function validateEmail(string $email): void {
        if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
            throw new ValidationException('Invalid email format');
        }
        if ($this->emailExists($email)) {
            throw new DuplicateEmailException('Email already registered');
        }
    }
}

目的:

• 無効なデータがシステムに入るのを防ぎます
• 複雑な操作の前に失敗することでリソースを節約します
• ユーザーに明確なエラー メッセージを提供します
• データの整合性を維持します

2. 設定のロード

class AppConfig {
    private array $config;

    public function __construct(string $configPath) {
        if (!file_exists($configPath)) {
            throw new ConfigurationException("Config file not found: $configPath");
        }

        $config = parse_ini_file($configPath, true);
        if ($config === false) {
            throw new ConfigurationException("Invalid config file format");
        }

        $this->validateRequiredSettings($config);
        $this->config = $config;
    }

    private function validateRequiredSettings(array $config): void {
        $required = ['database', 'api_key', 'environment'];
        foreach ($required as $key) {
            if (!isset($config[$key])) {
                throw new ConfigurationException("Missing required config: $key");
            }
        }
    }
}

目的:

• アプリケーションが有効な構成で起動することを保証します
• 設定不足による実行時エラーを防止します
• 構成の問題をすぐに可視化します
• 構成の問題のデバッグを簡素化します

3. リソースの初期化

class DatabaseConnection {
    private PDO $connection;

    public function __construct(array $config) {
        try {
            $this->validateDatabaseConfig($config);
            $this->connection = new PDO(
                $this->buildDsn($config),
                $config['username'],
                $config['password'],
                [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]
            );
        } catch (PDOException $e) {
            throw new DatabaseConnectionException(
                "Failed to connect to database: " . $e->getMessage()
            );
        }
    }

    private function validateDatabaseConfig(array $config): void {
        $required = ['host', 'port', 'database', 'username', 'password'];
        foreach ($required as $param) {
            if (!isset($config[$param])) {
                throw new DatabaseConfigException("Missing $param in database config");
            }
        }
    }
}

目的:

• リソースが適切に初期化されていることを確認します
• アプリケーションが無効なリソースで実行されるのを防ぎます
• 起動時にリソースの問題を可視化します
• 無効なリソースによる連鎖的な失敗を回避します

4. 外部サービスコール

class PaymentGateway {
    public function processPayment(Order $order): PaymentResult {
        // Validate API credentials
        if (!$this->validateApiCredentials()) {
            throw new ApiConfigurationException('Invalid API credentials');
        }

        // Validate order before external call
        if (!$order->isValid()) {
            throw new InvalidOrderException('Invalid order state');
        }

        try {
            $response = $this->apiClient->charge($order);

            if (!$response->isSuccessful()) {
                throw new PaymentFailedException($response->getError());
            }

            return new PaymentResult($response);
        } catch (ApiException $e) {
            throw new PaymentProcessingException(
                "Payment processing failed: " . $e->getMessage()
            );
        }
    }
}

目的:

• 無効なデータによる不要な API 呼び出しを防止します
• 時間とリソースを節約します
• API の問題について即座にフィードバックを提供します
• 外部サービスとの対話中にシステムの信頼性を維持します

5. データ処理パイプライン

class DataProcessor {
    public function processBatch(array $records): array {
        $this->validateBatchSize($records);

        $results = [];
        foreach ($records as $index => $record) {
            try {
                $this->validateRecord($record);
                $results[] = $this->processRecord($record);
            } catch (ValidationException $e) {
                throw new BatchProcessingException(
                    "Failed at record $index: " . $e->getMessage()
                );
            }
        }

        return $results;
    }

    private function validateBatchSize(array $records): void {
        if (empty($records)) {
            throw new EmptyBatchException('Empty batch provided');
        }

        if (count($records) > 1000) {
            throw new BatchSizeException('Batch size exceeds maximum limit');
        }
    }
}

目的:

• 処理全体を通じてデータの一貫性を確保します
• 無効なデータの部分的な処理を防止します
• データの問題を早期に可視化します
• 複雑なパイプラインでのエラー追跡を簡素化します
• 変換全体でデータの整合性を維持します

フェイルファストの利点

1. エラーの早期検出
2. よりクリーンなデバッグ
3. 連鎖的な障害を防止します
4. データの整合性を維持します
5. システムの信頼性を向上させます

ベストプラクティス

1. 強い型宣言を使用する
2. 徹底した入力検証を実装する
3. 特定の例外をスローする
4. プロセスの早い段階で検証する
5. 開発でアサーションを使用する
6. 適切なエラー処理を実装する
7. 失敗を適切にログに記録します

フェイルファストを使用する場合

1. 入力検証
2. 設定のロード中
3. リソースの初期化
4. 外部サービス呼び出し
5. データ処理パイプライン

以上がフェイルファストの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。