php error handler

Pustaka PHP ErrorHandler

Terjemahan : Spanyol

Pustaka PHP untuk menangani pengecualian.

Untuk menangani pengecualian, Anda dapat menggunakan perpustakaan pengendali pengecualian.

---

• Persyaratan
• Instalasi
• Kelas yang Tersedia
  • Kelas ErrorException
  • Kelas yang Ditangani Kesalahan
  • Kelas Pengendali Kesalahan
• Pengecualian Digunakan
• Penggunaan
• Tes
• TODO
• log perubahan
• Kontribusi
• Sponsor
• Lisensi

---

Persyaratan

• Sistem Operasi: Linux | jendela.

• Versi PHP: 8.1.

Instalasi

Cara yang lebih disukai untuk memasang ekstensi ini adalah melalui Komposer.

Untuk menginstal perpustakaan PHP ErrorHandler , cukup:

 composer require josantonius/error-handler

Perintah sebelumnya hanya akan menginstal file yang diperlukan, jika Anda lebih suka mengunduh seluruh kode sumber, Anda dapat menggunakan:

 composer require josantonius/error-handler --prefer-source

Anda juga dapat mengkloning repositori lengkap dengan Git:

 git clone https://github.com/josantonius/php-error-handler.git 

Kelas yang Tersedia

Kelas ErrorException

JosantoniusErrorHandlerErrorException Memperluas ErrorException

Mendapat file kesalahan:

 public function getFile(): string ;

Mendapatkan tingkat kesalahan:

 public function getLevel(): int ;

Mendapat baris file kesalahan:

 public function getLine(): int ;

Mendapat pesan kesalahan:

 public function getMessage(): string ;

Mendapat nama kesalahan:

 public function getName(): string ;

Kelas yang Ditangani Kesalahan

JosantoniusErrorHandlerErrorHandled

Mendapat file kesalahan:

 public function getFile(): string ;

Mendapatkan tingkat kesalahan:

 public function getLevel(): int ;

Mendapat baris file kesalahan:

 public function getLine(): int ;

Mendapat pesan kesalahan:

 public function getMessage(): string ;

Mendapat nama kesalahan:

 public function getName(): string ;

Kelas Pengendali Kesalahan

JosantoniusErrorHandlerErrorHandler

Ubah kesalahan menjadi pengecualian:

 /**
 * The errors will be thrown from the ErrorException instance.
 * 
 * @param int[] $errorLevel Define the specific error levels that will become exceptions.
 * 
 * @throws WrongErrorLevelException if error level is not valid.
 * 
 * @see https://www.php.net/manual/en/errorfunc.constants.php to view available error levels.
 */
public function convertToExceptions( int ... $ errorLevel ): ErrorHandler ;

Ubah kesalahan menjadi pengecualian kecuali beberapa di antaranya:

 /**
 * The errors will be thrown from the ErrorException instance.
 * 
 * @param int[] $errorLevel Define the specific error levels that will become exceptions.
 * 
 * @throws WrongErrorLevelException if error level is not valid.
 * 
 * @see https://www.php.net/manual/en/errorfunc.constants.php to view available error levels.
 */
public function convertToExceptionsExcept( int ... $ errorLevel ): ErrorHandler ;

Daftarkan fungsi pengendali kesalahan:

 /**
 * The error handler will receive the ErrorHandled object.
 * 
 * @see https://www.php.net/manual/en/functions.first_class_callable_syntax.php
 */
public function register( callable $ callback ): ErrorHandler ;

Gunakan pelaporan kesalahan untuk menentukan kesalahan mana yang ditangani:

 /**
 * If the setting value in error_reporting() is used to determine which errors are handled.
 *
 * If this method is not used, all errors will be sent to the handler.
 *
 * @see https://www.php.net/manual/en/function.error-reporting.php
 */
public function useErrorReportingLevel(): ErrorHandler ;

Pengecualian Digunakan

 use Josantonius  ErrorHandler  Exceptions  WrongErrorLevelException ;

Penggunaan

Contoh penggunaan perpustakaan ini:

Ubah semua kesalahan menjadi pengecualian

 use Josantonius  ErrorHandler  ErrorHandler ;

$ errorHandler = new ErrorHandler ();

$ errorHandler -> convertToExceptions ();

// All errors will be converted to exceptions.

Ubah kesalahan tertentu menjadi pengecualian

 use Josantonius  ErrorHandler  ErrorHandler ;

$ errorHandler = new ErrorHandler ();

$ errorHandler -> convertToExceptions ( E_USER_ERROR , E_USER_WARNING );

// Only E_USER_ERROR and E_USER_WARNING will be converted to exceptions.

Ubah semua kesalahan menjadi pengecualian kecuali beberapa di antaranya

 use Josantonius  ErrorHandler  ErrorHandler ;

$ errorHandler = new ErrorHandler ();

$ errorHandler -> convertToExceptionsExcept ( E_USER_DEPRECATED , E_USER_NOTICE );

// All errors except E_USER_DEPRECATED and E_USER_NOTICE will be converted to exceptions.

Konversikan ke pengecualian menggunakan tingkat pelaporan kesalahan

 use Josantonius  ErrorHandler  ErrorHandler ;

error_reporting ( E_USER_ERROR );

$ errorHandler = new ErrorHandler ();

$ errorHandler -> convertToExceptions ()-> useErrorReportingLevel ();

// Only E_USER_ERROR will be converted to exception.

Konversikan ke pengecualian dan gunakan penangan pengecualian

 use ErrorException ;
use Josantonius  ErrorHandler  ErrorHandler ;

set_exception_handler ( function ( ErrorException $ exception ) {
    var_dump ([
        ' level '   => $ exception -> getLevel (),
        ' message ' => $ exception -> getMessage (),
        ' file '    => $ exception -> getFile (),
        ' line '    => $ exception -> getLine (),
        ' name '    => $ exception -> getName (),
    ]);
});

$ errorHandler = new ErrorHandler ();

$ errorHandler -> convertToExceptions ();

// All errors will be converted to exceptions.

Daftarkan fungsi penanganan kesalahan

 use Josantonius  ErrorHandler  ErrorHandled ;
use Josantonius  ErrorHandler  ErrorHandler ;

function handler ( Errorhandled $ errorHandled ): void {
    var_dump ([
        ' level '   => $ errorHandled -> getLevel (),
        ' message ' => $ errorHandled -> getMessage (),
        ' file '    => $ errorHandled -> getFile (),
        ' line '    => $ errorHandled -> getLine (),
        ' name '    => $ errorHandled -> getName (),
    ]);
 }

$ errorHandler = new ErrorHandler ();

$ errorHandler -> register (
    callback: handler (...)
);

// All errors will be converted to exceptions.

Daftarkan fungsi pengendali kesalahan dan konversikan ke pengecualian

 use Josantonius  ErrorHandler  ErrorHandled ;
use Josantonius  ErrorHandler  ErrorHandler ;

class Handler {
    public static function errors ( Errorhandled $ exception ): void { /* do something */ }
}

$ errorHandler = new ErrorHandler ();

$ errorHandler -> register (
    callback: Handler:: errors (...)
)-> convertToExceptions ();

// The error will be sent to the error handler and then throw the exception.

Daftarkan fungsi penanganan kesalahan, konversikan ke pengecualian dan gunakan tingkat pelaporan kesalahan

 error_reporting ( E_USER_ERROR );

class Handler {
    public function errors ( Errorhandled $ exception ): void { /* do something */ }
}

$ handler = new Handler ();

$ errorHandled -> register (
    callback: $ handler -> errors (...),
)-> convertToExceptions ()-> useErrorReportingLevel ();

// Only E_USER_ERROR will be passed to the handler and converted to exception. 

Tes

Untuk menjalankan tes, Anda hanya perlu composer dan menjalankan perintah berikut:

 git clone https://github.com/josantonius/php-error-handler.git 

 cd php-error-handler 

 composer install

Jalankan pengujian unit dengan PHPUnit:

 composer phpunit

Jalankan tes standar kode dengan PHPCS:

 composer phpcs

Jalankan tes PHP Mess Detector untuk mendeteksi ketidakkonsistenan dalam gaya kode:

 composer phpmd

Jalankan semua tes sebelumnya:

 composer tests 

TODO

• Tambahkan fitur baru
• Tingkatkan tes
• Tingkatkan dokumentasi
• Tingkatkan terjemahan bahasa Inggris di file README
• Memfaktorkan ulang kode untuk aturan gaya kode yang dinonaktifkan (lihat phpmd.xml dan phpcs.xml)

log perubahan

Perubahan terperinci untuk setiap rilis didokumentasikan dalam catatan rilis.

Kontribusi

Pastikan untuk membaca Panduan Berkontribusi, sebelum membuat permintaan penarikan, memulai diskusi, atau melaporkan masalah.

Terima kasih kepada semua kontributor! ❤️

Sponsor

Jika proyek ini membantu Anda mengurangi waktu pengembangan, Anda dapat mensponsori saya untuk mendukung pekerjaan open source saya?

Lisensi

Repositori ini dilisensikan di bawah Lisensi MIT.

Hak Cipta © 2016-sekarang, Josantonius