核心要點(diǎn)

• PSR-3，一個(gè)通用的日志對(duì)象接口，允許開發(fā)者編寫可重用的代碼，而無需依賴任何特定的日志實(shí)現(xiàn)，從而提高了PHP中不同日志庫之間的兼容性。
• PSR-3接口提供了八種方法來處理不同嚴(yán)重級(jí)別的消息，以及一個(gè)通用的log()方法，可以接收任意嚴(yán)重級(jí)別。其設(shè)計(jì)目的是為了解決日志實(shí)現(xiàn)不兼容的問題。
• 盡管PSR-3有很多好處，但有些日志庫并不原生支持它。然而，開發(fā)者可以通過利用適配器模式和擴(kuò)展Psr/Log庫中提供的AbstractLogger類來創(chuàng)建符合PSR-3的適配器。
• 許多主要的PHP項(xiàng)目，包括Monolog、Symfony和Mustache.php，都已經(jīng)添加了對(duì)PSR-3的支持。由于它降低了代碼重用的障礙，預(yù)計(jì)會(huì)有更多庫和框架正確使用日志記錄，為開發(fā)者提供有用的信息。

在PHP開發(fā)中，日志記錄是最常見的任務(wù)之一。我們使用日志來跟蹤錯(cuò)誤消息、記錄重要事件和調(diào)試代碼問題。在任何PHP項(xiàng)目中，代碼中都可能充滿了對(duì)日志庫的調(diào)用，這些庫為我們處理這些操作。不幸的是，在代碼中散布著對(duì)日志庫的調(diào)用，這使得代碼依賴于該庫的可用性，這明顯違反了依賴倒置原則。即使我們使用依賴注入讓我們的對(duì)象訪問日志庫，日志庫之間的差異也意味著在它們之間切換可能很困難且費(fèi)時(shí)，需要對(duì)整個(gè)代碼庫進(jìn)行重大重構(gòu)。為了提高日志庫之間的兼容性，PHP-FIG小組最近發(fā)布了PSR-3，這是一個(gè)通用的日志對(duì)象接口。在本文中，我將討論P(yáng)SR-3定義的日志接口如何允許我們編寫不依賴于任何特定日志實(shí)現(xiàn)的可重用代碼。

PSR-3快速入門

在我們了解PSR-3如何使我們的代碼更可重用之前，有必要了解PSR-3是什么。如果您已經(jīng)熟悉PSR-3，可以跳過本節(jié)。規(guī)范的核心是日志對(duì)象的接口。此接口公開了八種方法來處理不同嚴(yán)重級(jí)別的消息，以及一個(gè)通用的log()方法，可以接受任意嚴(yán)重級(jí)別。PSR-3支持的八個(gè)嚴(yán)重級(jí)別基于RFC 5424，如下所述：

• emergency – 系統(tǒng)無法使用
• alert – 需要立即采取行動(dòng)
• critical – 嚴(yán)重狀況
• error – 不需要立即關(guān)注但應(yīng)監(jiān)控的錯(cuò)誤
• warning – 不尋?；虿幌Ｍl(fā)生的事件，但并非錯(cuò)誤
• notice – 正常但重要的事件
• info – 有趣的事件
• debug – 用于調(diào)試的詳細(xì)信息

每個(gè)日志方法都接受一個(gè)消息，該消息必須是字符串或具有__toString()方法的對(duì)象。附加參數(shù)接受一個(gè)數(shù)組，可以提供日志消息的上下文信息?？梢栽赑SR-3規(guī)范中找到這些方法和參數(shù)的完整說明。

獲取PSR-3文件

獲取使用PSR-3所需的文件很容易——您可以在Psr/Log GitHub存儲(chǔ)庫中找到它們。您也可以使用Composer從Packagist獲取這些文件。下面是一個(gè)用于檢索Psr/Log文件的示例composer.json文件：

{
    "require": {
        "psr/log": "dev-master"
    }
}

日志記錄如何限制代碼重用

PHP有很多不同的日志庫，每個(gè)庫都有自己收集和記錄數(shù)據(jù)的方法。雖然它們之間有一些共同點(diǎn)，但每個(gè)庫都有自己獨(dú)特的一套日志方法。這意味著在日志之間切換可能具有挑戰(zhàn)性，通常需要更改任何使用日志記錄的地方的代碼。這與代碼重用和面向?qū)ο笤O(shè)計(jì)的SOLID原則背道而馳。我們面臨的局面是：要么聲明對(duì)特定日志庫的依賴，要么完全避免日志記錄。為了更清楚地說明這個(gè)問題，需要一個(gè)具體的例子。假設(shè)我們正在創(chuàng)建一個(gè)簡(jiǎn)單的Mailer對(duì)象來處理發(fā)送電子郵件。我們希望Mailer在每次發(fā)送電子郵件時(shí)記錄一條消息，并且我們決定使用優(yōu)秀的Monolog庫來處理我們的日志記錄需求。

<?php namespace Email;

class Mailer
{
    private $logger;

    public function __construct($logger)
    {
        $this->logger = $logger;
    }

    public function sendEmail($emailAddress)
    {
        // 發(fā)送電子郵件的代碼...

        // 記錄消息
        $this->logger->addInfo("Email sent to $emailAddress");
    }
}

我們可以使用以下代碼使用此類：

<?php
// 創(chuàng)建一個(gè)Monolog對(duì)象
$logger = new Monolog\Logger("Mail");
$logger->pushHandler(new Monolog\Handler\StreamHandler("mail.log"));

// 創(chuàng)建郵件發(fā)送器并發(fā)送電子郵件
$mailer = new Email\Mailer($logger);
$mailer->sendEmail("email@example.com");

運(yùn)行此代碼將在mail.log文件中創(chuàng)建一個(gè)新條目，記錄已發(fā)送電子郵件。此時(shí)，我們可能會(huì)認(rèn)為我們已經(jīng)編寫了一個(gè)可重用的Mailer對(duì)象。我們使用依賴注入使日志記錄器可用于Mailer，因此我們可以交換不同的日志記錄器配置，而無需觸及我們的Mailer代碼?？雌饋砦覀円呀?jīng)成功遵循了SOLID原則并避免了創(chuàng)建任何硬依賴。但是，假設(shè)我們想在使用Analog處理日志記錄交互的不同項(xiàng)目中重用Mailer類。現(xiàn)在我們遇到了問題，因?yàn)锳nalog沒有addInfo()方法。要使用Analog記錄信息級(jí)別消息，我們調(diào)用Analog::log($message, Analog::INFO)。我們可以修改Mailer類以使用Analog的方法，如下所示。

<?php namespace Email;

class Mailer
{
    public function sendEmail($emailAddress)
    {
        // 發(fā)送電子郵件的代碼...

        // 記錄消息
        Analog::log("Email sent to $emailAddress", Analog::INFO);
    }
}

我們可以使用以下代碼使用更新后的Mailer類：

{
    "require": {
        "psr/log": "dev-master"
    }
}

雖然這會(huì)起作用，但這遠(yuǎn)非理想。我們遇到了Mailer對(duì)特定日志記錄實(shí)現(xiàn)的依賴，這要求在引入新的日志記錄器時(shí)更改類。這使得類不太可重用，并迫使我們必須在依賴于特定日志記錄器的可用性或完全放棄類中的日志記錄之間做出選擇。

使用PSR-3避免日志記錄器依賴

正如Alejandro Gervasio在他關(guān)于該主題的優(yōu)秀文章中解釋的那樣，依賴倒置原則告訴我們，我們應(yīng)該依賴抽象而不是具體實(shí)現(xiàn)。在日志記錄的情況下，我們目前的問題一直是缺乏一個(gè)可以依賴的合適的抽象。這就是PSR-3發(fā)揮作用的地方。PSR-3旨在通過為日志記錄器提供一個(gè)通用接口（恰當(dāng)?shù)孛麨?code>LoggerInterface）來克服日志記錄實(shí)現(xiàn)不兼容的問題。通過提供一個(gè)不綁定到任何特定實(shí)現(xiàn)的接口，PSR-3使我們無需依賴特定的日志記錄器——我們可以改為對(duì)LoggerInterface進(jìn)行類型提示以獲取符合PSR-3的日志記錄器。我已經(jīng)更新了下面的Mailer類來演示這一點(diǎn)：

<?php namespace Email;

class Mailer
{
    private $logger;

    public function __construct($logger)
    {
        $this->logger = $logger;
    }

    public function sendEmail($emailAddress)
    {
        // 發(fā)送電子郵件的代碼...

        // 記錄消息
        $this->logger->addInfo("Email sent to $emailAddress");
    }
}

構(gòu)造函數(shù)已修改為接受LoggerInterface的實(shí)現(xiàn)者，并且sendEmail()方法現(xiàn)在調(diào)用PSR-3中指定的info()方法。Monolog已經(jīng)符合PSR-3，并且Analog提供了一個(gè)實(shí)現(xiàn)LoggerInterface的包裝器對(duì)象，因此我們現(xiàn)在可以使用這兩個(gè)日志記錄器而無需修改Mailer類。以下是如何使用Monolog調(diào)用該類的：

<?php
// 創(chuàng)建一個(gè)Monolog對(duì)象
$logger = new Monolog\Logger("Mail");
$logger->pushHandler(new Monolog\Handler\StreamHandler("mail.log"));

// 創(chuàng)建郵件發(fā)送器并發(fā)送電子郵件
$mailer = new Email\Mailer($logger);
$mailer->sendEmail("email@example.com");

以及使用Analog：

<?php namespace Email;

class Mailer
{
    public function sendEmail($emailAddress)
    {
        // 發(fā)送電子郵件的代碼...

        // 記錄消息
        Analog::log("Email sent to $emailAddress", Analog::INFO);
    }
}

現(xiàn)在，我們能夠使用我們的Mailer對(duì)象與任何庫一起使用，而無需編輯Mailer類或更改我們使用它的方式。

為不支持PSR-3的日志記錄器使用適配器模式

到目前為止，我們已經(jīng)通過請(qǐng)求LoggerInterface的實(shí)現(xiàn)者成功地將Mailer對(duì)象與任何特定的日志記錄實(shí)現(xiàn)解耦。但是，那些尚未添加對(duì)PSR-3支持的日志記錄器呢？例如，流行的KLogger庫已經(jīng)有一段時(shí)間沒有更新了，目前與PSR-3不兼容。幸運(yùn)的是，我們可以通過利用適配器模式輕松地將KLogger公開的方法映射到LoggerInterface中定義的方法。Psr/Log存儲(chǔ)庫中的支持文件使我們能夠通過提供一個(gè)我們可以擴(kuò)展的AbstractLogger類來輕松創(chuàng)建適配器類。抽象類只是將LoggerInterface中定義的八個(gè)特定于級(jí)別的日志方法轉(zhuǎn)發(fā)到一個(gè)通用的log()方法。通過擴(kuò)展AbstractLogger類并定義我們自己的log()方法，我們可以輕松地為不原生支持PSR-3的日志記錄器創(chuàng)建符合PSR-3的適配器。我將在下面通過為KLogger創(chuàng)建一個(gè)簡(jiǎn)單的適配器來演示這一點(diǎn)：

{
    "require": {
        "psr/log": "dev-master"
    }
}

log()方法只是將LoggerInterface方法映射到各自的KLogger方法，而KLogger處理實(shí)際的日志記錄活動(dòng)。通過這種方式包裝KLogger類，我們能夠在不破壞LoggerInterface契約的情況下使用它。我們現(xiàn)在可以使用KLogger適配器與Mailer類一起使用：

<?php namespace Email;

class Mailer
{
    private $logger;

    public function __construct($logger)
    {
        $this->logger = $logger;
    }

    public function sendEmail($emailAddress)
    {
        // 發(fā)送電子郵件的代碼...

        // 記錄消息
        $this->logger->addInfo("Email sent to $emailAddress");
    }
}

使用適配器類，我們能夠在不修改Mailer類的情況下使用KLogger，并且仍然遵守LoggerInterface。KLogger不接受調(diào)試級(jí)別消息的第二個(gè)參數(shù)，因此即使使用適配器，它也不完全符合PSR-3。擴(kuò)展KLogger以使其完全與PSR-3兼容將是一項(xiàng)微不足道的任務(wù)，但這超出了本文的范圍。但是，可以肯定地說，使用我們的適配器類使我們非常接近完全符合PSR-3，并允許我們使用LoggerInterface與KLogger類一起使用。

結(jié)論

在本文中，我們已經(jīng)了解了如何使用PSR-3來幫助我們編寫與日志記錄器無關(guān)的代碼，這些代碼不依賴于特定的日志記錄實(shí)現(xiàn)。許多主要的PHP項(xiàng)目已經(jīng)添加了對(duì)PSR-3的支持，包括Monolog、Symfony和Mustache.php，以及Drupal等其他知名項(xiàng)目正在討論如何最好地集成它。由于PSR-3降低了代碼重用的障礙，我們應(yīng)該看到更多庫和框架正確使用日志記錄，為開發(fā)者提供有用的信息。PSR-3會(huì)影響您在應(yīng)用程序中使用日志記錄的方式嗎？請(qǐng)?jiān)谙旅娴脑u(píng)論部分告訴我們。

(圖片來自Fotolia)

(PSR-3日志記錄的常見問題解答部分，由于篇幅限制，此處省略。 可以根據(jù)需要添加。)

以上是PHP主|使用PSR-3登錄以提高可重用性的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！