Phar 歸檔的概念來自 Java? 技術(shù)的 JAR 歸檔，它允許使用單個文件打包應(yīng)用程序，這個文件中包含運行應(yīng)用程序所需的所有東西。該文件不同于單個可執(zhí)行文件，后者通常由編程語言生成，比如 C，因為該文件實際上是一個歸檔文件而非編譯過的應(yīng)用程序。因此 JAR 文件實際上包含組成應(yīng)用程序的文件，但是考慮到安全性，不對這些文件進(jìn)行仔細(xì)區(qū)分。Phar 擴(kuò)展正是基于類似的理念，但是在設(shè)計時主要針對 PHP 的 Web 環(huán)境。同樣，與 JAR 歸檔不同的是，Phar 歸檔可由 PHP 本身處理，因此不需要使用額外的工具來創(chuàng)建或使用。

Phar 擴(kuò)展對 PHP 來說并不是一個新鮮的概念。它最初使用 PHP 編寫并被命名為 PHP_Archive，然后在 2005 年被添加到 PEAR 庫。然而在實際中，解決這一問題的純 PHP 解決方案非常緩慢，因此 2007 年重新編寫為純 C 語言擴(kuò)展，同時添加了使用 SPL 的ArrayAccess?對象遍歷 Phar 歸檔的支持。自那時起，人們做了大量工作來改善 Phar 歸檔的性能。

創(chuàng)建 Phar

創(chuàng)建 Phar 文件需要執(zhí)行若干步驟。所有步驟需要用到某種形式的 PHP 命令完成創(chuàng)建，因為不存在用于創(chuàng)建歸檔的獨立工具。此外，要創(chuàng)建和修改 Phar 文件，php.ini 設(shè)置 phar.readonly 必須被設(shè)置為 0。在 PHP 的 Phar 歸檔內(nèi)打開和引用文件時不需要使用到該設(shè)置。

讓我們看一看創(chuàng)建可用于驅(qū)動應(yīng)用程序的 Phar 文件需要哪些步驟。應(yīng)用程序的設(shè)計目標(biāo)是從 Web 瀏覽器或命令提示符直接加載。第一步是創(chuàng)建 Phar 文件，因此我們將創(chuàng)建清單 1 所示的?Phar?對象。對象引用將允許您控制 Phar 歸檔的所有方面。

示例 1. 創(chuàng)建?Phar?對象

$p = new Phar(’/path/to/my.phar’, CURRENT_AS_FILEINFO | KEY_AS_FILENAME, ’my.phar’);$p->startBuffering();

構(gòu)造函數(shù)的第一個參數(shù)表示保存 Phar 文件的位置。第二個參數(shù)將所有參數(shù)都傳遞給?RecursiveDirectoryIterator?父類。第三個參數(shù)是在流上下文中引用 Phar 歸檔的別名。因此對于清單 1，可以在這個 Phar 歸檔中使用 phar://my.phar 引用文件。您還可以發(fā)出Phar::startBuffering()?方法調(diào)用來緩沖對歸檔做出的修改，直到發(fā)出?Phar::stopBuffering()?命令為止。盡管不一定要執(zhí)行上述操作，但是這樣做確實改善了創(chuàng)建或修改歸檔的性能，因為它避免了每次在腳本中修改歸檔時對做出的修改進(jìn)行保存。

默認(rèn)情況下，創(chuàng)建的 Phar 將使用原生的基于 Phar 的歸檔格式。還可以按照清單 2 所示將格式轉(zhuǎn)換為 ZIP 格式，從而對 Phar 文件使用 ZIP 或 TAR 格式。示例 2. 將存儲格式轉(zhuǎn)換為 ZIP 格式

$p = $p->convertToExecutable(Phar::ZIP);

轉(zhuǎn)換歸檔格式有利也有弊。主要優(yōu)點就是能夠使用任何處理 ZIP 或 TAR 文件的工具查看歸檔的內(nèi)容。然而，如果 Phar 歸檔沒有使用原生的基于 Phar 的歸檔格式，那么它不需要使用 Phar 擴(kuò)展加載歸檔，而使用 ZIP 或 TAR 格式的 Phar 歸檔則需要如此。

接下來，將需要定義文件存根（stub），這是在加載 Phar 文件時首先調(diào)用的代碼。

Phar 文件存根

文件存根僅僅是在加載 Phar 文件時最初運行的代碼的一小部分，并且始終以一個?__HALT_COMPILER()?標(biāo)記作為結(jié)束。清單 3 展示了一個典型的文件存根。示例 3. Phar 文件存根

<?php Phar::mapPhar(); include ’phar://myphar.phar/index.php’; __HALT_COMPILER();

上面所示的?Phar::mapPhar()?方法調(diào)用通過讀取清單文件（manifest）對 Phar 歸檔執(zhí)行初始化。您需要在歸檔內(nèi)引用文件之前使用 phar:// 流包裝器執(zhí)行初始化。初始加載的文件將是應(yīng)用程序首次加載時的文件；在本例中為 index.php。

如何將這個文件存根 Phar 添加到 Phar 歸檔取決于所使用的歸檔的格式。對于基于 Phar 的歸檔，使用?Phar::setStub()?方法，它將接受 PHP 代碼的惟一參數(shù)，并以字符串形式放入存根中。清單 4 演示了這一方法。示例 4. 使用?Phar::setStub()?創(chuàng)建文件存根

$p->setStub(’<?php Phar::mapPhar(); include ’phar://myphar.phar/index.php’; __HALT_COMPILER(); ?>’);

如果您計劃使用存根而不是重定向到 index.php 頁面來完成操作，可以使用 helper 方法?Phar::createDefaultStub()?構(gòu)建文件存根。因此，只需要傳遞您希望包含在文件存根的文件的名稱。在清單 5 中，將重寫?Phar::setStub()?方法調(diào)用來使用 helper 方法。

示例 5. 使用?Phar::createDefaultStub()?創(chuàng)建文件存根

$p->setStub($p-> createDefaultStub(’index.php’));

如果從 Web 服務(wù)器加載 Phar，Phar::createDefaultStub()?方法的第二個可選參數(shù)允許包含一個不同的文件。這對于設(shè)計用于命令行或 Web 瀏覽器上下文的應(yīng)用程序非常方便。

對于基于 ZIP 和 TAR 的實現(xiàn)，將以上存根的內(nèi)容存儲到 .phar/stub.php 文件內(nèi)，而不是使用?setStub()?命令。

將文件添加到歸檔

Phar?對象使用?ArrayAccess?SPL 對象，允許以數(shù)組的形式訪問歸檔內(nèi)容，因此提供了許多方法來向歸檔添加文件。最簡單的方法是直接使用?ArrayAccess?接口。示例 6. 向歸檔添加文件

$p[’file.txt’] = ’This is a text file’;$p[’index.php’] = file_get_contents(’index.php’);

示例 6 表明文件名被指定為數(shù)組鍵，將內(nèi)容指定為值。可以使用?file_get_contents()?函數(shù)獲得現(xiàn)有文件的內(nèi)容，然后將內(nèi)容設(shè)為值。這樣可以更加靈活地向歸檔添加文件，可以通過引用現(xiàn)有文件或動態(tài)構(gòu)建文件實現(xiàn)。后一種方法可以作為應(yīng)用程序構(gòu)建腳本的一部分。

如果存儲在 Phar 歸檔中的文件非常大，可以分別通過?PharFileInfo::setCompressedGZ()?或PharFileInfo::setCompressedBZIP2()?方法使用 gzip 或 bzip2 壓縮有選擇地壓縮歸檔中的文件。在清單 7 中，您將使用 bzip2 壓縮文件。示例 7. 使用 bzip2 壓縮 Phar 歸檔中的文件

$p[’big.txt’] = ’This is a big text file’;$p[’big.txt’]->setCompressedBZIP2();

要壓縮文件或使用包含壓縮文件的歸檔，必須在 PHP 安裝中支持 bzip2 或 zlib（用于 gz 壓縮文件）擴(kuò)展。

假設(shè)您需要將許多文件加入到歸檔中。使用?ArrayAccess?接口逐一添加文件是一項非常單調(diào)的工作，因此可以使用一些便捷的方法。一種方法就是使用?Phar::buildFromDirectory()?方法，該方法將遍歷指定的目錄并添加其中的文件。它還支持對添加的文件進(jìn)行過濾，方法是使用文件的正則表達(dá)式模式傳遞第二個參數(shù)，以匹配文件并添加到歸檔中。清單 8 展示了這一過程。示例 8. 使用?Phar::buildFromDirectory()?向歸檔添加文件

$p->buildFromDirectory(’/path/to/files’,’./.php$/’);

示例 8 將指定目錄中的 PHP 文件添加到 Phar 歸檔。如果需要對添加的文件執(zhí)行任何修改，比如將文件壓縮，那么可以使用ArrayAccess?接口返回。

可以使用一個迭代器（iterator）通過?Phar::buildFromIterator()?方法添加文件。支持兩種風(fēng)格的迭代器：一種是將 Phar 中的文件名映射到磁盤文件的名稱，另一種是返回?SplFileInfo?對象。RecursiveDirectoryIterator?是一種兼容的迭代器，下面展示如何使用它向歸檔添加目錄文件。示例 9. 使用?Phar::buildFromIterator()?向歸檔添加目錄文件

$p->buildFromIterator(new RecursiveIteratorIterator(new RecursiveDirectoryIterator(’/path/to/files’)),’/path/to/files’);

Phar::buildFromIterator()?方法接受迭代器對象本身作為惟一的參數(shù)。在上例中，您已經(jīng)使用RecursiveIteratorIterator?對象包裝了?RecursiveDirectoryIterator?對象，RecursiveIteratorIterator?對象提供了Phar::buildFromIterator()?方法所需的兼容型迭代器。

我們現(xiàn)在已經(jīng)創(chuàng)建了一個 Phar 歸檔，它可以用于任何 PHP 應(yīng)用程序。讓我們看一看如何方便地使用這個歸檔。

使用 Phar 歸檔

Phar 歸檔的一個優(yōu)點就是可以非常方便地集成到任何應(yīng)用程序中。如果使用的是原生的基于 Phar 的歸檔格式，這一點尤其明顯。在這種情況下，您甚至不需要安裝 Phar 擴(kuò)展，因為 PHP 天生就可以加載文件并提取文件內(nèi)容。基于 ZIP 和 TAR 的歸檔需要加載 Phar 擴(kuò)展。

Phar 歸檔在設(shè)計時被包括到應(yīng)用程序中，跟普通的 PHP 文件一樣，這使得已經(jīng)熟悉如何包含其他第三方代碼的應(yīng)用程序開發(fā)人員可以非常方便地使用 Phar 歸檔。讓我們看一看在應(yīng)用程序中集成 Phar 有多么容易。

在應(yīng)用程序中集成 Phar 歸檔代碼

在 Phar 歸檔中集成代碼的最簡單方法就是包含 Phar 歸檔，然后在 Phar 文件中包含需要使用的文件。phar:// 流包裝器可以用來訪問已加載 Phar 歸檔中的文件，如下所示。示例 10. 在 Phar 歸檔中加載代碼

include ’myphar.phar’; include ’phar://myphar.phar/file.php’;

第一個 include 將加載 myphar.phar 歸檔，包含文件存根中指定的代碼。第二個 include 使用流包裝器打開 Phar 歸檔并且僅在歸檔中包括指定的文件。注意在歸檔中包含文件之前，您不需要包含 Phar 歸檔本身，如清單 10 所示。

從 Phar 歸檔運行 PHP 應(yīng)用程序

Phar 歸檔的一個出色特性就是可以使用一個 Phar 歸檔打包整個應(yīng)用程序并進(jìn)行發(fā)布。這種方法的優(yōu)點就是簡化應(yīng)用程序部署并且不會降低性能，它主要得益于 PHP V5.3 中新增的若干 Phar 增強(qiáng)。然而，設(shè)計在 Phar 中運行的應(yīng)用程序時應(yīng)當(dāng)考慮以下幾點：

任何需要創(chuàng)建的特定于應(yīng)用程序?qū)嵗奈募热?config 文件，都不能作為歸檔的一部分，因此需要將它們寫入到獨立但是可訪問的位置。如果應(yīng)用程序創(chuàng)建構(gòu)成擴(kuò)展的緩存文件，那么這些文件也要采用相同的做法。您應(yīng)當(dāng)始終使用基于 Phar 的歸檔格式，并且不對歸檔中的文件進(jìn)行壓縮，從而獲得最大的靈活性。基于 ZIP 和 TAR 的歸檔要求在 PHP 中安裝 Phar 擴(kuò)展，而基于 Phar 的歸檔甚至可用于未安裝 Phar 擴(kuò)展的情況。應(yīng)用程序中的任何文件引用都需要修改為同時使用 phar:// 流包裝器和歸檔名，如前面小節(jié)所示。

PHPMyAdmin 是一種流行的 PHP 應(yīng)用程序，它一直使用 Phar 打包，演示出使用 Phar 歸檔的簡便性。它一直以來被設(shè)計為從 Phar 歸檔文件運行，但是仍然能夠在 Phar 歸檔之外存儲配置文件。