PHP-Entwicklungsframework Yii Framework-Tutorial (3) Fügen Sie der Anwendung Protokolle hinzu

Im Prozess der Anwendungsentwicklung ist das Debuggen neben dem von der IDE unterstützten Echtzeit-Debugging (z. B. VS.PHP oder der von der IDE unterstützten Debugging-Funktion) auch das Hinzufügen geeigneter Debugging-Informationen zum Web Anwendungen sind ebenfalls sehr nützlich. Jeder, der Java- oder .Net-Anwendungen entwickelt hat, ist mit log4XX vertraut und bietet auch eine ähnliche Protokollfunktion, Yii::log, die als integrierte Komponente von CWebApplication erscheint. Es kann über eine Konfigurationsdatei konfiguriert werden (die Konfiguration in Yii ist normalerweise protected/config/main.php).

Der vorherige Artikel Yii Framework Development Concise Tutorial (2) Yii Web Application Basics beschreibt kurz die Anwendungskomponenten.

Zusätzlich zur Protokollkomponente definiert Yii eine Reihe von Kernanwendungskomponenten vor, um Funktionen bereitzustellen, die in gängigen Webanwendungen verwendet werden. Beispielsweise wird die Anforderungskomponente verwendet, um Benutzeranfragen zu analysieren und Informationen wie URLs, Cookies usw. bereitzustellen. Durch die Konfiguration der Eigenschaften dieser Kernkomponenten können wir das Standardverhalten von Yii in nahezu jeder Hinsicht ändern.

Nachfolgend listen wir die von CWebApplication vordefinierten Kernkomponenten auf.

assetManager: CAssetManager – verwaltet die Freigabe privater Asset-Dateien.

authManager: CAuthManager – Verwaltet die rollenbasierte Zugriffskontrolle (RBAC).

Cache: CCache – Bietet Daten-Caching-Funktion. Beachten Sie, dass Sie die tatsächliche Klasse angeben müssen (z. B. CMemCache, CDbCache). Andernfalls wird NULL zurückgegeben, wenn Sie auf diese Komponente zugreifen.

clientScript: CClientScript – verwaltet Client-Skripte (Javascripts und CSS).

coreMessages: CPhpMessageSource – stellt die Übersetzung der vom Yii-Framework verwendeten Kernnachrichten bereit.

db: CDbConnection – Stellt eine Datenbankverbindung bereit. Beachten Sie, dass Sie zur Verwendung dieser Komponente die Eigenschaft „connectionString“ konfigurieren müssen.

errorHandler: CErrorHandler – Behandelt nicht erfasste PHP-Fehler und Ausnahmen.

Format: CFormatter – formatierte numerische Anzeige. Diese Funktion ist ab Version 1.1.0 verfügbar.

Nachrichten: CPhpMessageSource – Stellt Nachrichtenübersetzungen bereit, die in Yii-Anwendungen verwendet werden.

Anfrage: CHttpRequest – Stellt Informationen über die Anfrage des Benutzers bereit.

securityManager: CSecurityManager – Bietet sicherheitsbezogene Dienste wie Hashing und Verschlüsselung.

session: CHttpSession – Stellt sitzungsbezogene Funktionen bereit.

statePersister: CStatePersister – Stellt globale Zustandspersistenzmethoden bereit.

urlManager: CUrlManager – Bietet Funktionen zum Parsen und Erstellen von URLs.

Benutzer: CWebUser – Bietet Identifikationsinformationen des aktuellen Benutzers.

themeManager: CThemeManager – verwaltet Themen. Diese Komponenten werden in nachfolgenden Tutorials Schritt für Schritt eingeführt. Die grundlegende Methode zur Verwendung der Protokollfunktion ist unten angegeben: Hier ändern wir das Yii Framework Development Concise Tutorial (1) Die erste Anwendung ist Hello World. Fügen Sie ein Protokoll hinzu. 1. Erstellen Sie die Konfigurationsdatei protected/config/main.php. Wenn Sie das Protokoll in eine Datei schreiben möchten, können Sie die folgende Konfiguration verwenden:

// This is the main Web application configuration. Any writable// CWebApplication properties can be configured here.return array(
// preloading 'log' component'preload'=>array('log'),
// application components'components'=>array(
'log'=>array('class'=>'CLogRouter','routes'=>array(array('class'=>'CFileLogRoute','levels'=>'info,error, warning',),
),),),
);

CLogRouter-Informationsrouting wird über Yii: aufgezeichnet. log oder Yii::trace Informationen werden im Speicher gehalten. Normalerweise müssen wir sie in einem Browserfenster anzeigen oder sie in einem dauerhaften Speicher wie Dateien oder E-Mails speichern. Dies wird als Informationsrouting bezeichnet.

Im Allgemeinen müssen Sie bei Verwendung der Protokollfunktion die Protokollkomponente vorab laden. Durch Vorladen kann die Anwendung einige Module im Voraus laden. Tipp: Standardmäßig werden Anwendungskomponenten nach Bedarf erstellt. Dies bedeutet, dass eine Komponente nur erstellt wird, wenn auf sie zugegriffen wird. Daher wird die Gesamtleistung des Systems aufgrund der Konfiguration vieler Komponenten nicht beeinträchtigt. Einige Anwendungskomponenten (z. B. CLogRouter) werden unabhängig davon erstellt, ob sie verwendet werden oder nicht. In diesem Fall listen wir die IDs dieser Komponenten in der Konfigurationsdatei der Anwendung auf: preload.

2. Ändern Sie das Eingabeskript index.php und konfigurieren Sie die Hauptanwendungsinstanz für die Verwendung der neu erstellten Konfigurationsdatei.

$yii='C:/yiiframework/yii.php';
// remove the following line when in production mode
defined('YII_DEBUG') or define('YII_DEBUG',true);
$config=dirname(__FILE__).'/protected/config/main.php';
require_once($yii);
Yii::createWebApplication($config)->run();3. 创建protected/runtime

Da das Standardverzeichnis, in das Protokolldateien geschrieben werden, protected/runtime ist, muss das Laufzeitverzeichnis im Voraus erstellt werden, andernfalls zeigt Yii das Protokoll direkt auf der Webseite an.

4. Auf diese Weise können Sie Yii::log oder Yii::trace verwenden, um Protokolle zur Anwendung hinzuzufügen.

Der Unterschied besteht darin, dass Letzteres nur dann Informationen aufzeichnet, wenn die Anwendung im Debug-Modus ausgeführt wird.

Yii::log($message, $level, $category);
Yii::trace($message, $category);

Beim Aufzeichnen von Informationen müssen wir deren Kategorie und Ebene angeben. Die Kategorie ist eine Zeichenfolge mit einem Format ähnlich einem Pfadalias. Wenn beispielsweise eine Nachricht in CController aufgezeichnet wird, können wir system.web.CController als Klassifizierung verwenden. Die Informationsebene sollte einer der folgenden Werte sein:

trace: Dies ist die Ebene, die in Yii::trace verwendet wird. Es wird verwendet, um den Ausführungsfluss eines Programms während der Entwicklung zu verfolgen.

Info: Hiermit werden allgemeine Informationen erfasst.

Profil: Dies ist eine Leistungsübersicht (Profil). Genauere Anweisungen folgen in Kürze.

Warnung: Dies wird für Warninformationen verwendet.

Fehler: Dies wird für schwerwiegende Fehlermeldungen verwendet.

Yiis Protokolle werden nach Ebene und Kategorie klassifiziert und gefiltert. Wie bereits erwähnt, sollten mehrere Ebenen oder Kategorien durch Kommas verbunden werden.

由于 信息分类是类似 xxx.yyy.zzz 格式的，我们可以将其视为一个分类层级。 具体地，我们说 xxx 是 xxx.yyy 的父级，而 xxx.yyy 又是 xxx.yyy.zzz 的父级。 这样我们就可以使用 xxx.* 表示分类 xxx 及其所有的子级和孙级分类。

有了以 上知识，我们修改SiteController的actionIndex,添加一行日志。

public function actionIndex()
{
Yii::log("action","info","site.action");
$this->render("index");
}

5. 运行应用，可以看到Yii在protected/runtime 创建了一个application.log

其内容如下：

2012/12/11 21:23:38 [info] [site.action] action

注： 日志存放的位置和文件名都可以通过配置来修改，一般情 况使用缺省值就可以了，和log4X 类似，应用的日志可以通过路由同时写到多个目的地（文件，Email等）这些多可以通过配置 来实现，具体可以参见日志记录。

以上就是PHP开发框架Yii Framework教程(3) 为应用添加日志的内容，更多相关内容请关注PHP中文网（www.php.cn）！