您自己的自定義註釋 - 不僅僅是評論！

PHP自定義註解：增強代碼靈活性和可擴展性

本文探討如何在Symfony 3應用中創建和使用自定義註解。註解是我們在類、方法和屬性上方看到的文檔塊元數據/配置，常用於聲明控制器路由（@Route()）、Doctrine ORM映射（@ORM()）或控制對Rauth等包中各種類和方法的訪問。本文將介紹如何自定義註解，並在不加載類的情況下讀取類或方法信息。

關鍵要點:

• PHP自定義註解可用於向代碼添加元數據，影響代碼行為，使其更靈活、更易於適應。它們可用於定義路由信息、指定驗證規則或配置依賴注入。
• 創建PHP自定義註解需要定義一個新的類來表示該註解。此類應具有與您希望在註解中設置的值相對應的屬性。
• Doctrine支持自定義註解。您可以定義自己的註解並將其用於Doctrine實體中。 Doctrine的註解讀取器將解析這些註解，然後可以使用它們來影響實體的行為。
• 使用PHP自定義註解的一個限制是它們不受語言本身的原生支持。這意味著您需要使用提供註解支持的庫或工具，例如Doctrine或PHP-DI。
• PHP自定義註解的用途多種多樣，包括在Web應用程序中定義路由信息、為表單輸入指定驗證規則或配置依賴注入。它們還可用於向代碼添加文檔。

免責聲明: 註解與Symfony無關，它是作為Doctrine項目的一部分開發的概念，用於解決將ORM信息映射到類方法的問題。

本文將構建一個名為WorkerBundle的小型可重用捆綁包（僅用於演示目的，並非真正可打包的）。我們將開發一個小型概念，允許定義各種以不同速度“運行”的Worker類型，然後應用程序中的任何人都可以使用它們。實際的worker操作不在本文的討論範圍之內，因為我們關注的是設置管理它們的系統（並通過註解發現它們）。

您可以查看這個倉庫並按照其中介紹的說明在本地Symfony應用程序中設置捆綁包。

Worker

Worker將實現一個接口，該接口需要一個方法：::work()。在新的WorkerBundle中，讓我們創建一個Workers/目錄來保持整潔，並在其中添加接口：

<?php
namespace WorkerBundle\Workers;

interface WorkerInterface
{
    /**
     * 执行工作
     *
     * @return NULL
     */
    public function work();
}

註解

每個worker都必須實現上述接口。很清楚。但除此之外，我們還需要它們在類上方有一個註解，以便找到它們並讀取有關它們的某些元數據。

Doctrine將文檔塊註解映射到一個類，該類的屬性表示註解本身內部的鍵。讓我們創建我們自己的註解並實際操作一下。

每個WorkerInterface實例在其文檔塊中都將具有以下註解：

<?php
namespace WorkerBundle\Workers;

interface WorkerInterface
{
    /**
     * 执行工作
     *
     * @return NULL
     */
    public function work();
}

我們將保持簡單，只有兩個屬性：唯一名稱（字符串）和worker速度（整數）。為了使Doctrine的註解庫能夠識別此註解，我們必須創建一個匹配的類，不出所料，它自己也有一些註解。

我們將此類放在捆綁包命名空間的Annotation文件夾中，並將其簡單地命名為Worker：

/**
 * @Worker(
 *     name = "唯一的Worker名称",
 *     speed = 10
 * )
 */

如您所見，我們有兩個屬性和一些簡單的getter方法。更重要的是，我們在頂部有兩個註解：@Annotation（告訴Doctrine此類表示一個註解）和@Target("CLASS")（告訴它應該在整個類而不是方法或屬性上方使用）。就是這樣，WorkerInterface類現在可以通過確保在文件頂部使用use語句導入相應的類來使用此註解：

<?php
namespace WorkerBundle\Annotation;

use Doctrine\Common\Annotations\Annotation;

/**
 * @Annotation
 * @Target("CLASS")
 */
class Worker
{
    /**
     * @Required
     *
     * @var string
     */
    public $name;

    /**
     * @Required
     *
     * @var int
     */
    public $speed;

    /**
     * @return string
     */
    public function getName()
    {
        return $this->name;
    }

    /**
     * @return int
     */
    public function getSpeed()
    {
        return $this->speed;
    }
}

管理器

接下來，我們需要一個管理器，我們的應用程序可以使用它來獲取所有可用worker的列表並創建它們。在與WorkerInterface相同的命名空間中，我們可以使用這個簡單的管理器類：

use WorkerBundle\Annotation\Worker;

發現器

我們註解演示的關鍵部分實際上是發現過程的一部分。為什麼？因為我們使用Worker註解來確定是否應將相應的類視為Worker。在此過程中，我們在實際實例化對象之前使用了元數據。讓我們看看我們的WorkerDiscovery類：

<?php
namespace WorkerBundle\Workers;

class WorkerManager
{
    // ... (代码与原文相同) ...
}

連接起來

現在我們有了主要組件，是時候將所有內容連接起來了。首先，我們需要服務定義，因此在捆綁包的Resource/config文件夾中，我們可以有這個services.yml文件：

<?php
namespace WorkerBundle\Workers;

// ... (代码与原文相同) ...
}

為了使我們的服務定義能夠被容器集中拾取，我們需要編寫一個小的擴展類。因此，在捆綁包的DependencyInjection文件夾中，創建一個名為WorkerExtension的類。位置和名稱對於Symfony自動拾取它都很重要。

services:
    worker_manager:
        class: WorkerBundle\Workers\WorkerManager
        arguments: ["@worker_discovery"]
    worker_discovery:
        class: WorkerBundle\Workers\WorkerDiscovery
        arguments: ["%worker_namespace%", "%worker_directory%", "%kernel.root_dir%", "@annotation_reader"]

最後，我們需要註冊我們的捆綁包。在我們的AppKernel中：

<?php
namespace WorkerBundle\DependencyInjection;

// ... (代码与原文相同) ...
}

就是這樣。

讓我們工作！

現在我們準備工作了。讓我們在中央parameters.yml文件中配置我們的worker將在哪裡找到：

public function registerBundles()
{
    return array(
        // ...
        new WorkerBundle\WorkerBundle(),
        // ...
    );
}

這些參數從容器傳遞到WorkerDiscovery類，如上所述。

位置由您決定，但現在讓我們將我們的worker放在應用程序的主要AppBundle捆綁包中。我們的第一個worker可能如下所示：

<?php
namespace WorkerBundle\Workers;

interface WorkerInterface
{
    /**
     * 执行工作
     *
     * @return NULL
     */
    public function work();
}

我們的註解在那裡，use語句到位，因此沒有任何東西可以阻止某些業務邏輯找到它並實例化它。讓我們假設在一個Controller方法內部：

/**
 * @Worker(
 *     name = "唯一的Worker名称",
 *     speed = 10
 * )
 */

或者

<?php
namespace WorkerBundle\Annotation;

use Doctrine\Common\Annotations\Annotation;

/**
 * @Annotation
 * @Target("CLASS")
 */
class Worker
{
    /**
     * @Required
     *
     * @var string
     */
    public $name;

    /**
     * @Required
     *
     * @var int
     */
    public $speed;

    /**
     * @return string
     */
    public function getName()
    {
        return $this->name;
    }

    /**
     * @return int
     */
    public function getSpeed()
    {
        return $this->speed;
    }
}

結論

我們現在可以使用註解來表達有關類（或方法和屬性）的元數據。在本教程中，我們構建了一個小型包，它使應用程序（或其他外部捆綁包）能夠通過定義有關它們的某些元數據來聲明能夠執行某些工作的worker。此元數據不僅使它們易於發現，而且還提供有關是否應該實際使用它們的信息。

您在自己的項目中使用自定義註解嗎？如果是這樣，您是如何實現它們的？也許還有第三種方法？讓我們知道！

---

(感興趣了解更多關於Symfony、Doctrine、註解以及各種企業級PHP內容的信息？加入我們，參加為期三天的動手研討會，WebSummerCamp——唯一一個完全手動的會議，並且還會照顧您想帶去的任何人！)

(原文的FAQ部分已省略，因為其內容與已翻譯和改寫的內容高度重複。)

以上是您自己的自定義註釋 - 不僅僅是評論！的詳細內容。更多資訊請關注PHP中文網其他相關文章！