国产av日韩一区二区三区精品,成人性爱视频在线观看,国产,欧美,日韩,一区,www.成色av久久成人,2222eeee成人天堂

目錄
PHP自定義註解:增強代碼靈活性和可擴展性
首頁 後端開發(fā) php教程 您自己的自定義註釋 - 不僅僅是評論!

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

Feb 15, 2025 am 09:22 AM

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

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

關鍵要點:

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

Your Own Custom Annotations - More than Just Comments!

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

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

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

Worker

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

<?php
namespace WorkerBundle\Workers;

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

註解

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

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

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

<?php
namespace WorkerBundle\Workers;

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

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

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

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

如您所見,我們有兩個屬性和一些簡單的getter方法。更重要的是,我們在頂部有兩個註解:@Annotation(告訴Doctrine此類表示一個註解)和@Target("CLASS")(告訴它應該在整個類而不是方法或屬性上方使用)。就是這樣,WorkerInterface類現(xiàn)在可以通過確保在文件頂部使用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的列表並創(chuàng)建它們。在與WorkerInterface相同的命名空間中,我們可以使用這個簡單的管理器類:

use WorkerBundle\Annotation\Worker;

發(fā)現(xiàn)器

我們註解演示的關鍵部分實際上是發(fā)現(xiàn)過程的一部分。為什麼?因為我們使用Worker註解來確定是否應將相應的類視為Worker。在此過程中,我們在實際實例化對象之前使用了元數(shù)據(jù)。讓我們看看我們的WorkerDiscovery類:

<?php
namespace WorkerBundle\Workers;

class WorkerManager
{
    // ... (代碼與原文相同) ...
}

連接起來

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

<?php
namespace WorkerBundle\Workers;

// ... (代碼與原文相同) ...
}

為了使我們的服務定義能夠被容器集中拾取,我們需要編寫一個小的擴展類。因此,在捆綁包的DependencyInjection文件夾中,創(chuàng)建一個名為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;

// ... (代碼與原文相同) ...
}

就是這樣。

讓我們工作!

現(xiàn)在我們準備工作了。讓我們在中央parameters.yml文件中配置我們的worker將在哪裡找到:

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

這些參數(shù)從容器傳遞到WorkerDiscovery類,如上所述。

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

<?php
namespace WorkerBundle\Workers;

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

我們的註解在那裡,use語句到位,因此沒有任何東西可以阻止某些業(yè)務邏輯找到它並實例化它。讓我們假設在一個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;
    }
}

結論

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

Your Own Custom Annotations - More than Just Comments!

您在自己的項目中使用自定義註解嗎?如果是這樣,您是如何實現(xiàn)它們的?也許還有第三種方法?讓我們知道!


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

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

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

本網(wǎng)站聲明
本文內容由網(wǎng)友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發(fā)現(xiàn)涉嫌抄襲或侵權的內容,請聯(lián)絡admin@php.cn

熱AI工具

Undress AI Tool

Undress AI Tool

免費脫衣圖片

Undresser.AI Undress

Undresser.AI Undress

人工智慧驅動的應用程序,用於創(chuàng)建逼真的裸體照片

AI Clothes Remover

AI Clothes Remover

用於從照片中去除衣服的線上人工智慧工具。

Clothoff.io

Clothoff.io

AI脫衣器

Video Face Swap

Video Face Swap

使用我們完全免費的人工智慧換臉工具,輕鬆在任何影片中換臉!

熱工具

記事本++7.3.1

記事本++7.3.1

好用且免費的程式碼編輯器

SublimeText3漢化版

SublimeText3漢化版

中文版,非常好用

禪工作室 13.0.1

禪工作室 13.0.1

強大的PHP整合開發(fā)環(huán)境

Dreamweaver CS6

Dreamweaver CS6

視覺化網(wǎng)頁開發(fā)工具

SublimeText3 Mac版

SublimeText3 Mac版

神級程式碼編輯軟體(SublimeText3)

如何在PHP中實施身份驗證和授權? 如何在PHP中實施身份驗證和授權? Jun 20, 2025 am 01:03 AM

tosecurelyhandleauthenticationandationallizationInphp,lofterTheSesteps:1.AlwaysHashPasswordSwithPassword_hash()andverifyusingspasspassword_verify(),usepreparedStatatementStopreventsqlineptions,andStoreSeruserDatain usseruserDatain $ _sessiveferterlogin.2.implementrole-2.imaccessccsccccccccccccccccccccccccc.

如何在PHP中安全地處理文件上傳? 如何在PHP中安全地處理文件上傳? Jun 19, 2025 am 01:05 AM

要安全處理PHP中的文件上傳,核心在於驗證文件類型、重命名文件並限制權限。 1.使用finfo_file()檢查真實MIME類型,僅允許特定類型如image/jpeg;2.用uniqid()生成隨機文件名,存儲至非Web根目錄;3.通過php.ini和HTML表單限製文件大小,設置目錄權限為0755;4.使用ClamAV掃描惡意軟件,增強安全性。這些步驟有效防止安全漏洞,確保文件上傳過程安全可靠。

PHP中==(鬆散比較)和===(嚴格的比較)之間有什麼區(qū)別? PHP中==(鬆散比較)和===(嚴格的比較)之間有什麼區(qū)別? Jun 19, 2025 am 01:07 AM

在PHP中,==與===的主要區(qū)別在於類型檢查的嚴格程度。 ==在比較前會進行類型轉換,例如5=="5"返回true,而===要求值和類型都相同才會返回true,例如5==="5"返回false。使用場景上,===更安全應優(yōu)先使用,==僅在需要類型轉換時使用。

如何在PHP( - , *, /,%)中執(zhí)行算術操作? 如何在PHP( - , *, /,%)中執(zhí)行算術操作? Jun 19, 2025 pm 05:13 PM

PHP中使用基本數(shù)學運算的方法如下:1.加法用 號,支持整數(shù)和浮點數(shù),也可用於變量,字符串數(shù)字會自動轉換但不推薦依賴;2.減法用-號,變量同理,類型轉換同樣適用;3.乘法用*號,適用於數(shù)字及類似字符串;4.除法用/號,需避免除以零,並註意結果可能是浮點數(shù);5.取模用%號,可用於判斷奇偶數(shù),處理負數(shù)時餘數(shù)符號與被除數(shù)一致。正確使用這些運算符的關鍵在於確保數(shù)據(jù)類型清晰並處理好邊界情況。

如何與PHP的NOSQL數(shù)據(jù)庫(例如MongoDB,Redis)進行交互? 如何與PHP的NOSQL數(shù)據(jù)庫(例如MongoDB,Redis)進行交互? Jun 19, 2025 am 01:07 AM

是的,PHP可以通過特定擴展或庫與MongoDB和Redis等NoSQL數(shù)據(jù)庫交互。首先,使用MongoDBPHP驅動(通過PECL或Composer安裝)創(chuàng)建客戶端實例並操作數(shù)據(jù)庫及集合,支持插入、查詢、聚合等操作;其次,使用Predis庫或phpredis擴展連接Redis,執(zhí)行鍵值設置與獲取,推薦phpredis用於高性能場景,Predis則便於快速部署;兩者均適用於生產環(huán)境且文檔完善。

我如何了解最新的PHP開發(fā)和最佳實踐? 我如何了解最新的PHP開發(fā)和最佳實踐? Jun 23, 2025 am 12:56 AM

TostaycurrentwithPHPdevelopmentsandbestpractices,followkeynewssourceslikePHP.netandPHPWeekly,engagewithcommunitiesonforumsandconferences,keeptoolingupdatedandgraduallyadoptnewfeatures,andreadorcontributetoopensourceprojects.First,followreliablesource

什麼是PHP,為什麼它用於Web開發(fā)? 什麼是PHP,為什麼它用於Web開發(fā)? Jun 23, 2025 am 12:55 AM

PHPbecamepopularforwebdevelopmentduetoitseaseoflearning,seamlessintegrationwithHTML,widespreadhostingsupport,andalargeecosystemincludingframeworkslikeLaravelandCMSplatformslikeWordPress.Itexcelsinhandlingformsubmissions,managingusersessions,interacti

如何設置PHP時區(qū)? 如何設置PHP時區(qū)? Jun 25, 2025 am 01:00 AM

tosetTherightTimeZoneInphp,restate_default_timezone_set()functionAtthestArtofyourscriptWithavalIdidentIdentifiersuchas'america/new_york'.1.usedate_default_default_timezone_set_set()

See all articles