PHP Composer 以及PSR規範

背景說明

進入個人博客

www.sourcedev.cc/

隨着項目代碼量的不斷增長，以及一些庫的依賴，咱們不得不引入包的管理，來解決不易管理、閱讀、模塊化等問題。 三方庫優秀，並且不少人在維護，功能對接也方便，咱們沒有必要在這個一個經常使用的功能上花費時間來封裝或者造輪子， 不少人在本身的項目中都實踐過，出現了問題，反應的issue也很快會被解決掉，功能也不斷在完善。 一直強調，站在巨人的肩膀上，咱們會走的更遠，也許咱們本身擼出來的代碼難等大雅之堂，沒法比擬， 把重心放在本身的核心產品和功能時間上，學會借鑑學習和使用，下降本身的開發成本。 也許有人會以爲我使用三方庫可能會形成性能上的影響，有些功能我根本用不到。項目中代碼有不少無用的代碼，致使文件加載過慢， 其實不用擔憂， opcache能夠將php腳本預編譯到共享內存中來提高php的性能。

php Composer psr-4 autoload

Composer 是php用來管理依賴關係的工具，能夠在項目中聲明外部依賴的工具庫，Composer會幫你安裝這些依賴的庫文件 psr-4 是一種代碼規範，可以實現package的自動加載，規範瞭如何從文件路徑自動加載類，同時也規範了自動加載文件的位置

自動加載

咱們在支持Composer的項目中，只需引入這個文件，加上下面這段php的代碼，就能夠獲得自動加載的支持了

<?php

require_once __DIR __ . '/vendor/autoload.php';

複製代碼

composer.json

{
    "autoload": {
        "psr-4": {
            "Work\\": "src/"
        },
        "psr-0": {
            "Vendor_Namespace_": "src/"
        }
    }
}
複製代碼

Composer 將註冊一個 PSR-4 autoloader 到 Work 命名空間, PSR-0 則支持_，自動轉化爲目錄結構

classmap

不遵循PSR-0/4規範的類庫，

files

明確的指定文件加載

額外的

repositories 自定義資源包庫

type

• composer Composer 類型的資源庫，是一個簡單的網絡服務器上的
• vcs git、svn、hg等
• pear 從pear上獲取資源
• package 內聯一個composer.json對象

scripts

Composer 容許你在安裝過程當中的各個階段掛接腳本。

詳細流程

典型的命令，composer安裝時

• post-install-cmd composer install執行以後觸發
• post-update-cmd composer update執行以後觸發

自定義腳本demo

{
    "scripts": {
        "post-update-cmd": "MyVendor\\MyClass::postUpdate",
        "post-package-install": [
            "MyVendor\\MyClass::postPackageInstall"
        ],
        "post-install-cmd": [
            "MyVendor\\MyClass::warmCache",
            "phpunit -c app/",
            "find vendor -type d -name .git -exec rm -rf '{}' \\;"
        ]
    }
}
複製代碼

<?php

namespace MyVendor;

use Composer\Script\Event;

class MyClass {
    public static function postUpdate(Event $event) {
        $composer = $event->getComposer();
        // do stuff
    }

    public static function postPackageInstall(Event $event) {
        $installedPackage = $event->getOperation()->getPackage();
        // do stuff
    }

    public static function warmCache(Event $event) {
        // make cache toasty
    }
}
複製代碼

否則看出執行的腳本能夠是一個類中的靜態方法，固然也能夠是一個函數，還能夠是一條shell命令

咱們也能夠手動執行一些命令

composer run-script [--dev] [--no-dev] script
複製代碼

擴展

順便了解一下其餘的幾個代碼規範

PSR

psr-0 自動加載

psr-1 基本代碼規範

• 文件內只出現 <?php 和 <?= 標籤 （必須）
• 只是用utf-8 沒有BOM頭的php代碼 （必須）
• 聲明新的類型符，不產生反作用
• 命名空間遵循autoload自動加載psr-0/4規範（必須）
• 類名駝峯（必須）
• 類中的常量下劃線_分隔（必須）
• 方法駝峯（必須）

psr-2 代碼樣式

• 必須遵循psr-1
• 四個空格，而非tab
• 限制每行長度 80或者更少
• namespace 和 use 必須空格
• 類的括號必須獨立一行
• 類的方法也同樣
• 全部的屬性和方法必須在修飾符以前，static在以後
• 關鍵詞以後必須有空格
• 代碼流程控制，{ 在一行，}獨立一行
• {以後沒有空格，}以前沒有空格

psr-3 日誌接口

• 錯誤級別RFC 5424 （debug, info, notice, warning, error, critical, alert, emergency）

psr-4 自動加載

相比於 psr-0 規範比較乾淨 PSR-0規範中下劃線_會被轉化成爲目錄分割線 上面有詳細的介紹，這裏就再也不重複

psr-6 緩存接口

psr-7 http消息接口

psr-11 容器接口

psr-13 超媒體連接

psr-15 http句柄

psr-16 簡單緩存

收集或者查看過的

• php規範

• python入門思惟導圖