Gagal Cepat

Prinsip Teras

Kesan dan laporkan kegagalan sebaik sahaja ia berlaku, menghalang keadaan tidak sah daripada merebak melalui sistem.

1. Pengesahan Input

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');
        }
    }
}

Tujuan:

• Menghalang data tidak sah daripada memasuki sistem
• Menjimatkan sumber dengan gagal sebelum operasi yang rumit
• Memberikan mesej ralat yang jelas kepada pengguna
• Mengekalkan integriti data

2. Pemuatan Konfigurasi

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");
            }
        }
    }
}

Tujuan:

• Memastikan aplikasi bermula dengan konfigurasi yang sah
• Menghalang ralat masa jalan kerana tetapan tiada
• Menjadikan masalah konfigurasi kelihatan serta-merta
• Memudahkan isu konfigurasi penyahpepijatan

3. Permulaan Sumber

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");
            }
        }
    }
}

Tujuan:

• Memastikan sumber dimulakan dengan betul
• Menghalang aplikasi daripada berjalan dengan sumber yang tidak sah
• Menjadikan masalah sumber kelihatan semasa permulaan
• Mengelakkan kegagalan melata disebabkan oleh sumber yang tidak sah

4. Panggilan Perkhidmatan Luaran

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()
            );
        }
    }
}

Tujuan:

• Menghalang panggilan API yang tidak diperlukan dengan data tidak sah
• Menjimatkan masa dan sumber
• Memberi maklum balas segera tentang isu API
• Mengekalkan kebolehpercayaan sistem semasa interaksi perkhidmatan luaran

5. Talian Paip Pemprosesan Data

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');
        }
    }
}

Tujuan:

• Memastikan konsistensi data sepanjang pemprosesan
• Menghalang pemprosesan separa data tidak sah
• Menjadikan masalah data kelihatan lebih awal
• Memudahkan pengesanan ralat dalam saluran paip yang kompleks
• Mengekalkan integriti data merentas transformasi

Faedah Fail Fast

1. Pengesanan ralat awal
2. Penyahpepijatan yang lebih bersih
3. Menghalang kegagalan berlatarkan
4. Mengekalkan integriti data
5. Meningkatkan kebolehpercayaan sistem

Amalan Terbaik

1. Gunakan pengisytiharan jenis yang kuat
2. Laksanakan pengesahan input yang menyeluruh
3. Lemparkan pengecualian khusus
4. Sahkan awal dalam proses
5. Gunakan penegasan dalam pembangunan
6. Laksanakan pengendalian ralat yang betul
7. Kegagalan log dengan sewajarnya

Bila Guna Gagal Cepat

1. Pengesahan input
2. Pemuatan konfigurasi
3. Permulaan sumber
4. Panggilan perkhidmatan luaran
5. Saluran paip pemprosesan data

Atas ialah kandungan terperinci Gagal Cepat. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!