Yii Framework Offizieller Leitfaden Serie 46 – Spezialthema: Fehlerbehandlung

Yii bietet einen vollständigen Fehlerbehandlungsmechanismus basierend auf der PHP5-Ausnahmebehandlung. Wenn eine Anwendung ausgeführt wird und Benutzeranfragen verarbeitet, wird die Methode handleError für die Verarbeitung von PHP-Warnungen und Hinweisinformationen registriert. Die Methode handleException wird auch für die Verarbeitung nicht abgefangener PHP-Ausnahmen registriert. Wenn daher während der Ausführung der Anwendung eine PHP-Warnung/ein PHP-Hinweis oder eine nicht abgefangene PHP-Ausnahme auftritt, übernimmt der Fehlerbehandler die Kontrolle und führt die erforderlichen Behandlungsmechanismen aus.

Tipp: Der Fehlerhandler wird in der Konstruktormethode der Anwendung mithilfe der PHP-Funktionen set_Exception_handler und set_error_handler registriert. Wenn Sie nicht möchten, dass Yii Fehler und Ausnahmen behandelt, können Sie YII_ENABLE_ERROR_HANDLER und YII_ENABLE_EXCEPTION_HANDLER in der Eintragsdatei als false definieren.

Standardmäßig ist das Ereignis onError (oder Ereignis onException). ausgelöst wird, wird der Fehlerhandler (oder Ausnahmehandler) ausgelöst. Wenn der Fehler oder die Ausnahme von keinem Ereignis behandelt wird, müssen Sie die Komponente „errorHandler“ ausführen, um ihn zu behandeln.

1. Ausnahmen auslösen

Ausnahmen in Yii auszulösen ist dasselbe wie in gewöhnlichen PHP-Dateien. Sie können den folgenden Code verwenden, um eine Ausnahme auszulösen:

throw new ExceptionClass('错误信息');

Yii definiert zwei Ausnahmeklassen: CException und CHttpException . Erstere ist eine allgemeine Ausnahmeklasse, während letztere dazu verwendet wird, Endbenutzern Ausnahmeinformationen anzuzeigen. Gleichzeitig verfügt letzteres über ein statusCode-Attribut zur Darstellung des HTTP-Statuscodes. Die Art der Ausnahme bestimmt den Anzeigeeffekt, auf den weiter unten noch näher eingegangen wird.

Tipp: Wenn Sie dem Benutzer mitteilen möchten, dass ein bestimmter Vorgang falsch ist, ist das Auslösen einer CHttpException der einfachste Weg. Wenn der Benutzer beispielsweise einen ungültigen ID-Wert in der URL angibt, können wir einen 404-Fehler anzeigen:

// 如果提交的ID是无效的
throw new CHttpException(404,'此页面不存在');

2. Fehler anzeigen

Wenn ein Fehler an die Komponente CErrorHandler weitergeleitet wird, wählt diese die entsprechende Ansicht zur Anzeige des Fehlers aus. Wenn der Fehler dem Endbenutzer angezeigt werden soll (z. B. eine CHttpException), wird eine Ansicht mit dem Namen errorXXX verwendet, um den Fehler anzuzeigen. Dieses XXX stellt einen HTTP-Fehlercode dar (z. B. 400, 404, 500 usw.). Wenn es sich um einen internen Fehler handelt, der nur für Entwickler sichtbar sein sollte, wird der Ansichtsname exception verwendet. Im letzteren Fall werden die vollständigen Call-Stack-Informationen und Fehlerzeileninformationen angezeigt.

Informationen: Wenn die Anwendung im Produktionsmodus ausgeführt wird, werden alle Fehler, einschließlich interner Fehler, in der Ansicht errorXXX angezeigt. Dies liegt daran, dass die Aufrufstapelinformationen und Fehlerzeileninformationen möglicherweise vertrauliche Informationen enthalten. In diesem Fall sollten sich Entwickler auf Fehlerprotokolle verlassen, um die Fehlerursache zu ermitteln.

CErrorHandler sucht nach der entsprechenden Ansicht, um die Fehlermeldung anzuzeigen. Die Suchreihenfolge ist wie folgt:

1. WebRoot/themes/ThemeName/views/system: system unter aktuelle Theme-Ansicht im Verzeichnis.

2. WebRoot/protected/views/system: Im Verzeichnis system der Standardansicht der App.

3. yii/framework/views: Im von Yii bereitgestellten Standardansichtsverzeichnis.

Wenn Sie daher die Fehleranzeige anpassen möchten, können Sie eine Ansichtsdatei direkt im system-Ansichtsverzeichnis oder im system-Ansichtsverzeichnis des Themes erstellen. Jede Ansichtsdatei ist eine normale PHP-Datei, die viel HTML-Code enthält. Weitere Informationen finden Sie in den Dateien im Verzeichnis view des Frameworks.

3. Verwenden Sie eine Aktion, um Fehler zu behandeln.

Yii kann auch Controller-Aktionen verwenden, um die Fehleranzeige zu verwalten. Dies wird durch die Konfiguration eines Fehlerhandlers in der Konfigurationsdatei der Anwendung erreicht.

return array(
    ......
    'components'=>array(
        'errorHandler'=>array(
            'errorAction'=>'site/error',
        ),
    ),
);

Im obigen Code konfigurieren wir das Attribut CErrorHandler::errorAction und der Attributwert ist a Routesite/error. Diese Route zeigt auf SiteController innerhalb von error. Natürlich können Sie auch andere Routen nutzen.

Wir können die errorAktion so schreiben:

public function actionError()
{
    if($error=Yii::app()->errorHandler->error)
        $this->render('error', $error);
}

In dieser Aktion Rufen Sie zunächst detaillierte Fehlerinformationen von CErrorHandler::error ab. Wenn die erhaltenen Informationen nicht leer sind, verwenden Sie die von CErrorHandler::error zurückgegebenen Informationen, um die error-Ansicht zu rendern. Die von CErrorHandler::error zurückgegebenen Informationen sind ein Array mit der folgenden Struktur:

• code: HTTP-Statuscode (z. B. 403, 500);

• type: Fehlertyp (z. B. CHttpException, PHP Error

• : Fehlermeldung; 🎜>message: Der Name der PHP-Datei, in der der Fehler aufgetreten ist;

• file: Die Zeile, in der der Fehler aufgetreten ist; 🎜>

  : Die falschen Aufrufstapelinformationen;

• line

  : Der Kontext des Codes, in dem der Fehler aufgetreten ist.

Tipp: Der Grund, warum wir prüfen, ob CErrorHandler::error leer ist, besteht darin, dass der Benutzer auf die Aktion error zugreifen kann, möglicherweise aber nicht Es kann zu diesem Zeitpunkt kein Fehler vorliegen. Wenn wir das Array $error an die Ansicht übergeben, wird es automatisch als unabhängige Variable freigegeben. In der Ansicht können wir also $code, $type verwenden, um auf diese Informationen zuzugreifen.

4. Nachrichtenaufzeichnung

Eine Fehlermeldung der Ebene error wird protokolliert, wenn ein Fehler auftritt. Wenn der Fehler durch eine PHP-Warnung oder einen PHP-Hinweis verursacht wird, wird die Nachricht in der Kategorie php aufgezeichnet. Wenn die Fehlermeldung durch eine nicht abgefangene Ausnahme verursacht wird, lautet die Kategorie exception.ExceptionClassName (für CHttpException beispielsweise deren Statuscode). wird auch an den Kategorienamen angehängt). Entwickler können diese Datensätze verwenden, um Fehlermeldungen während der Anwendungsausführung zu überwachen

Das Obige ist der offizielle Yii Framework-Leitfaden Serie 46 – Spezialthema: Fehlerbehandlung. Weitere verwandte Inhalte finden Sie auf der chinesischen PHP-Website (www.php.org). php .cn)!