核心要點(diǎn)

• PSR-3，一個(gè)通用的日誌對象接口，允許開發(fā)者編寫可重用的代碼，而無需依賴任何特定的日誌實(shí)現(xiàn)，從而提高了PHP中不同日誌庫之間的兼容性。
• PSR-3接口提供了八種方法來處理不同嚴(yán)重級別的消息，以及一個(gè)通用的log()方法，可以接收任意嚴(yán)重級別。其設(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)添加了對PSR-3的支持。由於它降低了代碼重用的障礙，預(yù)計(jì)會有更多庫和框架正確使用日誌記錄，為開發(fā)者提供有用的信息。

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

PSR-3快速入門

在我們了解PSR-3如何使我們的代碼更可重用之前，有必要了解PSR-3是什麼。如果您已經(jīng)熟悉PSR-3，可以跳過本節(jié)。規(guī)範(fàn)的核心是日誌對象的接口。此接口公開了八種方法來處理不同嚴(yán)重級別的消息，以及一個(gè)通用的log()方法，可以接受任意嚴(yán)重級別。 PSR-3支持的八個(gè)嚴(yán)重級別基於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()方法的對象。附加參數(shù)接受一個(gè)數(shù)組，可以提供日誌消息的上下文信息?？梢栽赑SR-3規(guī)範(fàn)中找到這些方法和參數(shù)的完整說明。

獲取PSR-3文件

獲取使用PSR-3所需的文件很容易——您可以在Psr/Log GitHub存儲庫中找到它們。您也可以使用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原則背道而馳。我們面臨的局面是：要么聲明對特定日誌庫的依賴，要么完全避免日誌記錄。為了更清楚地說明這個(gè)問題，需要一個(gè)具體的例子。假設(shè)我們正在創(chuàng)建一個(gè)簡單的Mailer對象來處理髮送電子郵件。我們希望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對象
$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í)，我們可能會認(rèn)為我們已經(jīng)編寫了一個(gè)可重用的Mailer對象。我們使用依賴注入使日誌記錄器可用於Mailer，因此我們可以交換不同的日誌記錄器配置，而無需觸及我們的Mailer代碼?？雌饋砦覀円呀?jīng)成功遵循了SOLID原則並避免了創(chuàng)建任何硬依賴。但是，假設(shè)我們想在使用Analog處理日誌記錄交互的不同項(xiàng)目中重用Mailer類。現(xiàn)在我們遇到了問題，因?yàn)锳nalog沒有addInfo()方法。要使用Analog記錄信息級別消息，我們調(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"
    }
}

雖然這會起作用，但這遠(yuǎn)非理想。我們遇到了Mailer對特定日誌記錄實(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使我們無需依賴特定的日誌記錄器——我們可以改為對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的包裝器對象，因此我們現(xiàn)在可以使用這兩個(gè)日誌記錄器而無需修改Mailer類。以下是如何使用Monolog調(diào)用該類的：

<?php
// 創(chuàng)建一個(gè)Monolog對象
$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對象與任何庫一起使用，而無需編輯Mailer類或更改我們使用它的方式。

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

到目前為止，我們已經(jīng)通過請求LoggerInterface的實(shí)現(xiàn)者成功地將Mailer對象與任何特定的日誌記錄實(shí)現(xiàn)解耦。但是，那些尚未添加對PSR-3支持的日誌記錄器呢？例如，流行的KLogger庫已經(jīng)有一段時(shí)間沒有更新了，目前與PSR-3不兼容。幸運(yùn)的是，我們可以通過利用適配器模式輕鬆地將KLogger公開的方法映射到LoggerInterface中定義的方法。 Psr/Log存儲庫中的支持文件使我們能夠通過提供一個(gè)我們可以擴(kuò)展的AbstractLogger類來輕鬆創(chuàng)建適配器類。抽像類只是將LoggerInterface中定義的八個(gè)特定於級別的日誌方法轉(zhuǎn)發(fā)到一個(gè)通用的log()方法。通過擴(kuò)展AbstractLogger類並定義我們自己的log()方法，我們可以輕鬆地為不原生支持PSR-3的日誌記錄器創(chuàng)建符合PSR-3的適配器。我將在下面通過為KLogger創(chuàng)建一個(gè)簡單的適配器來演示這一點(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)試級別消息的第二個(gè)參數(shù)，因此即使使用適配器，它也不完全符合PSR-3。擴(kuò)展KLogger以使其完全與PSR-3兼容將是一項(xiàng)微不足道的任務(wù)，但這超出了本文的範(fàn)圍。但是，可以肯定地說，使用我們的適配器類使我們非常接近完全符合PSR-3，並允許我們使用LoggerInterface與KLogger類一起使用。

結(jié)論

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

(圖片來自Fotolia)

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

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