Übersetzungen : Español
PHP-Bibliothek zur Behandlung von Ausnahmen.
Um Ausnahmen zu behandeln, können Sie die Ausnahmehandlerbibliothek verwenden.
Betriebssystem: Linux | Windows.
PHP-Versionen: 8.1.
Die bevorzugte Methode zur Installation dieser Erweiterung ist Composer.
Um die PHP-ErrorHandler-Bibliothek zu installieren, gehen Sie einfach wie folgt vor:
composer require josantonius/error-handler
Mit dem vorherigen Befehl werden nur die erforderlichen Dateien installiert. Wenn Sie lieber den gesamten Quellcode herunterladen möchten, können Sie Folgendes verwenden:
composer require josantonius/error-handler --prefer-source
Sie können das komplette Repository auch mit Git klonen :
git clone https://github.com/josantonius/php-error-handler.git
JosantoniusErrorHandlerErrorException
Erweitert ErrorException
Ruft die Fehlerdatei ab:
public function getFile(): string ;
Ruft die Fehlerstufe ab:
public function getLevel(): int ;
Ruft die Zeile der Fehlerdatei ab:
public function getLine(): int ;
Erhält eine Fehlermeldung:
public function getMessage(): string ;
Ruft den Fehlernamen ab:
public function getName(): string ;
JosantoniusErrorHandlerErrorHandled
Ruft die Fehlerdatei ab:
public function getFile(): string ;
Ruft die Fehlerstufe ab:
public function getLevel(): int ;
Ruft die Zeile der Fehlerdatei ab:
public function getLine(): int ;
Erhält eine Fehlermeldung:
public function getMessage(): string ;
Ruft den Fehlernamen ab:
public function getName(): string ;
JosantoniusErrorHandlerErrorHandler
Fehler in Ausnahmen umwandeln:
/**
* 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 ;
Konvertieren Sie Fehler in Ausnahmen, mit Ausnahme einiger davon:
/**
* 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 ;
Fehlerbehandlungsfunktion registrieren:
/**
* 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 ;
Verwenden Sie die Fehlerberichterstattung, um zu bestimmen, welche Fehler behandelt werden:
/**
* 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 ;
use Josantonius ErrorHandler Exceptions WrongErrorLevelException ;
Anwendungsbeispiele für diese Bibliothek:
use Josantonius ErrorHandler ErrorHandler ;
$ errorHandler = new ErrorHandler ();
$ errorHandler -> convertToExceptions ();
// All errors will be converted to exceptions.
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.
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.
use Josantonius ErrorHandler ErrorHandler ;
error_reporting ( E_USER_ERROR );
$ errorHandler = new ErrorHandler ();
$ errorHandler -> convertToExceptions ()-> useErrorReportingLevel ();
// Only E_USER_ERROR will be converted to exception.
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.
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.
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.
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.
Um Tests auszuführen, benötigen Sie lediglich Composer und führen Folgendes aus:
git clone https://github.com/josantonius/php-error-handler.git
cd php-error-handler
composer install
Führen Sie Unit-Tests mit PHPUnit durch:
composer phpunit
Führen Sie Code-Standardtests mit PHPCS durch:
composer phpcs
Führen Sie PHP Mess Detector-Tests aus, um Inkonsistenzen im Codestil zu erkennen:
composer phpmd
Führen Sie alle vorherigen Tests aus:
composer tests
Detaillierte Änderungen für jede Version sind in den Versionshinweisen dokumentiert.
Bitte lesen Sie unbedingt den Beitragsleitfaden, bevor Sie eine Pull-Anfrage stellen, eine Diskussion starten oder ein Problem melden.
Vielen Dank an alle Mitwirkenden! ❤️
Wenn Ihnen dieses Projekt hilft, Ihre Entwicklungszeit zu verkürzen, können Sie mich dann sponsern, um meine Open-Source-Arbeit zu unterstützen?
Dieses Repository ist unter der MIT-Lizenz lizenziert.
Copyright © 2016-heute, Josantonius