PHP Academy · Pelajaran

Mencipta Pengecualian Tersuai

Panjangkan kelas Exception untuk membina jenis ralat khusus domain.

Pelajaran 3 daripada 413 langkah

Mencipta Pengecualian Tersuai ialah pelajaran PHP Academy percuma di CoddyKit. Ini ialah pelajaran 3 daripada 4. Anda boleh membaca keseluruhan pelajaran di bawah secara percuma — kemudian berlatih secara praktikal dalam pelayar menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran PHP Academy, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus PHP Academy merangkumi sejumlah 4 pelajaran.

Mengapa Pengecualian Tersuai?

Pengecualian tersuai membolehkan anda:

  • Membezakan ralat aplikasi anda daripada ralat PHP umum
  • Membawa data khusus domain (ID pesanan, ID pengguna dan sebagainya)
  • Menangkap jenis ralat tertentu pada lapisan yang berbeza
  • Mencipta hierarki ralat yang bermakna dan menerangkan dirinya sendiri

Melanjutkan Exception

Cipta pengecualian tersuai dengan melanjutkan kelas asas Exception:

<?php
class ValidationException extends \Exception
{
    private array $errors;

    public function __construct(array $errors, string $message = '', int $code = 0)
    {
        $this->errors = $errors;
        parent::__construct($message ?: implode(', ', $errors), $code);
    }

    public function getErrors(): array
    {
        return $this->errors;
    }
}

Menggunakan Pengecualian Tersuai

Lontarkan dan tangkap pengecualian tersuai anda:

<?php
function createUser(array $data): void {
    $errors = [];
    if (empty($data['email'])) $errors[] = 'Email required';
    if (empty($data['name']))  $errors[] = 'Name required';

    if ($errors) {
        throw new ValidationException($errors);
    }
    // save user...
}

try {
    createUser([]);
} catch (ValidationException $e) {
    foreach ($e->getErrors() as $err) {
        echo '- ' . $err . PHP_EOL;
    }
}

Reka Bentuk Hierarki Pengecualian

Reka bentuk hierarki untuk domain anda:

<?php
// Base exception for your app
class AppException extends \RuntimeException {}

// Domain-specific exceptions
class NotFoundException extends AppException {}
class AuthException extends AppException {}
class PaymentException extends AppException {}

// Specific payment errors
class InsufficientFundsException extends PaymentException {
    public function __construct(public readonly float $balance, public readonly float $required) {
        parent::__construct("Insufficient funds: have $balance, need $required");
    }
}

Menangkap Mengikut Hierarki

Tangkap kelas asas untuk mengendalikan semua pengecualian terbitan:

<?php
try {
    processPayment($order);
} catch (InsufficientFundsException $e) {
    echo 'Low balance: need ' . $e->required;
} catch (PaymentException $e) {
    echo 'Payment failed: ' . $e->getMessage();
} catch (AppException $e) {
    echo 'App error: ' . $e->getMessage();
} catch (\Throwable $e) {
    // Last resort
    error_log($e);
}

Menambah Konteks pada Pengecualian

Perkayakan pengecualian dengan data tambahan untuk penyahpepijatan:

<?php
class HttpException extends \RuntimeException
{
    public function __construct(
        private int    $statusCode,
        string         $message = '',
        ?\Throwable    $previous = null
    ) {
        parent::__construct($message, $statusCode, $previous);
    }

    public function getStatusCode(): int
    {
        return $this->statusCode;
    }
}

Contoh Pengecualian HTTP

Menggunakan pengecualian HTTP dalam aplikasi web:

<?php
try {
    $user = findUserById($id);
    if (!$user) throw new HttpException(404, 'User not found');
    if (!$user->canAccess($resource)) {
        throw new HttpException(403, 'Access denied');
    }
} catch (HttpException $e) {
    http_response_code($e->getStatusCode());
    echo json_encode(['error' => $e->getMessage()]);
}

Pengecualian Berasaskan Antara Muka

Gunakan antara muka untuk mengumpulkan kelas pengecualian yang tidak berkaitan:

<?php
interface UserFacingException
{
    public function getUserMessage(): string;
}

class ValidationException extends \Exception implements UserFacingException
{
    public function getUserMessage(): string
    {
        return 'Please check your input: ' . $this->getMessage();
    }
}

// In controller:
catch (UserFacingException $e) {
    echo $e->getUserMessage();
}

Corak Pembina Bernama

Gunakan kaedah kilang statik untuk senario pengecualian biasa:

<?php
class OrderException extends \RuntimeException
{
    public static function notFound(int $id): self
    {
        return new self("Order #$id not found", 404);
    }

    public static function alreadyShipped(int $id): self
    {
        return new self("Order #$id already shipped", 409);
    }
}

throw OrderException::notFound($orderId);

Menukarkan Pengecualian kepada Siri

Tukarkan data pengecualian kepada tatasusunan untuk pengelogan atau respons API:

<?php
function exceptionToArray(\Throwable $e): array {
    return [
        'type'    => get_class($e),
        'message' => $e->getMessage(),
        'code'    => $e->getCode(),
        'file'    => $e->getFile(),
        'line'    => $e->getLine(),
        'trace'   => $e->getTraceAsString(),
        'previous' => $e->getPrevious()
            ? exceptionToArray($e->getPrevious())
            : null,
    ];
}

Amalan Terbaik untuk Pengecualian Tersuai

Garis panduan untuk mereka bentuk pengecualian tersuai:

  • Lanjutkan RuntimeException untuk keadaan yang tidak dijangka
  • Lanjutkan LogicException untuk ralat pengatur cara (argumen tidak sah)
  • Jangan cipta kelas pengecualian untuk setiap mesej yang mungkin — gunakan kod sebaliknya
  • Kekalkan nama kelas pengecualian dalam PascalCase yang berakhir dengan Exception
  • Dokumentasikan pengecualian yang boleh dilontarkan oleh setiap kaedah

Semakan Pantas

Kelas asas PHP manakah yang patut anda lanjutkan untuk mencipta pengecualian tersuai yang mewakili ralat logik dalam kod anda?

Imbas Kembali: Pengecualian Tersuai

Ringkasan pengecualian tersuai:

  • Lanjutkan Exception atau subkelas
  • Tambah sifat dan kaedah khusus domain
  • Reka bentuk hierarki — tangkap induk untuk menangkap semua anak
  • Gunakan antara muka untuk mengumpulkan pengecualian yang tidak berkaitan
  • Gunakan pembina bernama statik untuk kejelasan
  • Sentiasa panggil parent::__construct()
Percuma untuk bermula

Pelajari PHP dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus
49
Pelajaran
195

Soalan Lazim

Adakah pelajaran “Mencipta Pengecualian Tersuai” percuma?

Ya — teks penuh “Mencipta Pengecualian Tersuai” boleh dibaca secara percuma di web ini. Untuk berlatih secara interaktif menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7, serta membuka kunci baki kursus PHP Academy, tingkat taraf kepada CoddyKit PRO. Kursus PHP Academy merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “Mencipta Pengecualian Tersuai”?

Panjangkan kelas Exception untuk membina jenis ralat khusus domain. Anda berlatih PHP Academy menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan PHP Academy?

Tiada pengalaman terdahulu diperlukan. Pembelajaran PHP Academy di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 3 daripada 4.

Berapa lamakah pelajaran “Mencipta Pengecualian Tersuai” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran PHP Academy ini?

Ya. Setiap pelajaran PHP Academy menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

  1. Jenis dan Pelaporan Ralat PHP
  2. Try, Catch dan Finally
  3. Mencipta Pengecualian Tersuai
  4. Mencatat Ralat dan Amalan Terbaik
← Kembali ke PHP Academy