PHP開發(fā)之歸檔格式phar文件概念與用法詳解【創(chuàng)建,使用,解包還原提取】
本文實例講述了PHP開發(fā)之歸檔格式phar文件概念與用法。分享給大家供大家參考，具體如下：
一個php應(yīng)用程序往往是由多個文件構(gòu)成的，如果能把他們集中為一個文件來分發(fā)和運(yùn)行是很方便的，這樣的列子有很多，比如在window操作系統(tǒng)上面的安裝程序、一個jquery庫等等，為了做到這點php采用了phar文檔文件格式，這個概念源自java的jar，但是在設(shè)計時主要針對 PHP 的 Web 環(huán)境，與 JAR 歸檔不同的是Phar 歸檔可由 PHP 本身處理，因此不需要使用額外的工具來創(chuàng)建或使用，使用php腳本就能創(chuàng)建或提取它。phar是一個合成詞，由PHP 和 Archive構(gòu)成，可以看出它是php歸檔文件的意思。
關(guān)于phar的官網(wǎng)文檔請見http://php.net/manual/zh/book.phar.php，本文檔可以看做和官網(wǎng)文檔互為補(bǔ)充
phar歸檔文件有三種格式：tar歸檔、zip歸檔、phar歸檔，前兩種執(zhí)行需要php安裝Phar 擴(kuò)展支持，用的也比較少，這里主要講phar歸檔格式。
phar格式歸檔文件可以直接執(zhí)行，它的產(chǎn)生依賴于Phar擴(kuò)展，由自己編寫的php腳本產(chǎn)生。
Phar 擴(kuò)展對 PHP 來說并不是一個新鮮的概念，在php5.3已經(jīng)內(nèi)建于php中，它最初使用 PHP 編寫并被命名為 PHP_Archive，然后在 2005 年被添加到 PEAR 庫。由于在實際中，解決這一問題的純 PHP 解決方案非常緩慢，因此 2007 年重新編寫為純 C 語言擴(kuò)展，同時添加了使用 SPL 的 ArrayAccess 對象遍歷 Phar 歸檔的支持。自那時起，人們做了大量工作來改善 Phar 歸檔的性能。
Phar 擴(kuò)展依賴于php流包裝器，關(guān)于此可參考前面一篇文章PHP流Streams、包裝器wrapper概念與用法實例詳解
很多php應(yīng)用都是以phar格式分發(fā)并運(yùn)行的，著名的有依賴管理：composer、單元測試：phpunit，下面我們來看一看如何創(chuàng)建、運(yùn)行、提取還原。
phar文件的創(chuàng)建：
首先在php.ini中修改phar.readonly這個選項，去掉前面的分號，并改值為off，由于安全原因該選項默認(rèn)是on，如果在php.ini中是禁用的（值為0或off），那么在用戶腳本中可以開啟或關(guān)閉，如果在php.ini中是開啟的，那么用戶腳本是無法關(guān)閉的，所以這里設(shè)置為off來展示示例。
我們來建立一個項目，在服務(wù)器根目錄中建立項目文件夾為project，目錄內(nèi)的結(jié)構(gòu)如下：
file -yunek.js -yunke.css lib -lib_a.php template -msg.html index.php Lib.php
其中file文件夾有兩個內(nèi)容為空的js和css文件，僅僅演示phar可以包含多種文件格式
lib_a.php內(nèi)容如下：
<?php
/**
* Created by yunke.
* User: yunke
* Date: 2017/2/10
* Time: 9:23
*/
function show(){
echo "l am show()";
}
msg.html內(nèi)容如下：
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>phar</title> </head> <body> <?=$str; ?> </body> </html>
index.php內(nèi)容如下：
<?php /** * Created by yunke. * User: yunke * Date: 2017/2/10 * Time: 9:17 */ require "lib/lib_a.php"; show(); $str = isset($_GET["str"]) ? $_GET["str"] : "hello world"; include "template/msg.html";
Lib.php內(nèi)容如下：
<?php
/**
* Created by yunke.
* User: yunke
* Date: 2017/2/10
* Time: 9:20
*/
function yunke()
{
echo "l am yunke()";
}
項目文件準(zhǔn)備好了，開始創(chuàng)建，現(xiàn)在在project文件夾同級目錄建立一個yunkeBuild.php，用于產(chǎn)生phar格式文件，內(nèi)容如下：
<?php
/**
* Created by yunke.
* User: yunke
* Date: 2017/2/10
* Time: 9:36
*/
//產(chǎn)生一個yunke.phar文件
$phar = new Phar('yunke.phar', 0, 'yunke.phar');
// 添加project里面的所有文件到y(tǒng)unke.phar歸檔文件
$phar->buildFromDirectory(dirname(__FILE__) . '/project');
//設(shè)置執(zhí)行時的入口文件，第一個用于命令行，第二個用于瀏覽器訪問，這里都設(shè)置為index.php
$phar->setDefaultStub('index.php', 'index.php');
然后在瀏覽器中訪問這個yunkeBuild.php文件，將產(chǎn)生一個yunke.phar文件，此時服務(wù)器根目錄結(jié)構(gòu)如下：
project yunkeBuild.php yunke.phar
這就是產(chǎn)生一個phar歸檔文件最簡單的過程了，更多內(nèi)容請看官網(wǎng)，這里需要注意的是如果項目不具備單一執(zhí)行入口則不宜使用phar歸檔文件
phar歸檔文件的使用：
我們在服務(wù)器根目錄建立一個index.php文件來演示如何使用上面創(chuàng)建的phar文件，內(nèi)容如下：
<?php /** * Created by yunke. * User: yunke * Date: 2017/2/8 * Time: 9:33 */ require "yunke.phar"; require "phar://yunke.phar/Lib.php"; yunke();
如果index.php文件中只有第一行，那么和不使用歸檔文件時，添加如下代碼完全相同：
require "project/index.php";
如果沒有第二行，那么第三行的yunke()將提示未定義，所以可見require一個phar文件時并不是導(dǎo)入了里面所有的文件，而只是導(dǎo)入了入口執(zhí)行文件而已，但在實際項目中往往在這個入口文件里導(dǎo)入其他需要使用的文件，在本例中入口執(zhí)行文件為project/index.php
phar文件的提取還原：
我們有時候會好奇phar里面包含的文件源碼，這個時候就需要將phar文件還原，如果只是看一看的話可以使用一些ide工具，比如phpstorm 10就能直接打開它，如果需要修改那么就需要提取操作了，為了演示，我們下載一個composer.phar放在服務(wù)器目錄，在根目錄建立一個get.php文件，內(nèi)容如下：
<?php
/**
* Created by yunke.
* User: yunke
* Date: 2017/2/9
* Time: 19:02
*/
$phar = new Phar('composer.phar');
$phar->extractTo('composer'); //提取一份原項目文件
$phar->convertToData(Phar::ZIP); //另外再提取一份，和上行二選一即可
用瀏覽器訪問這個文件，即可提取出來，以上列子展示了兩種提取方式：第二行將建立一個composer目錄，并將提取出來的內(nèi)容放入，第三行將產(chǎn)生一個composer.zip文件，解壓即可得到提取還原的項目文件。
補(bǔ)充：
1、在部署phar文件到生產(chǎn)服務(wù)器時需要調(diào)整服務(wù)器的配置，避免當(dāng)訪問時瀏覽器直接下載phar文件
2、可以為歸檔設(shè)置別名，別名保存在歸檔文件中永久保存，它可以用一個簡短的名字引用歸檔，而不管歸檔文件在文件系統(tǒng)中存儲在那里，設(shè)置別名：
$phar = new Phar('lib/yunke.phar', 0);
$phar->setAlias ( "yun.phar");
設(shè)置別名后可以如下使用：
<?php require "lib/yunke.phar"; require "phar://yun.phar/Lib.php"; //使用別名訪問歸檔文件 require "phar://lib/yunke.phar/Lib.php"; //當(dāng)然仍然可以使用這樣的方式去引用
如果在制作phar文件時沒有指定別名，也可以在存根文件里面使用Phar::mapPhar('yunke.phar');指定
3、歸檔文件中有一個存根文件，其實就是一段php執(zhí)行代碼，在制作歸檔時可以設(shè)置，直接執(zhí)行歸檔文件時，其實就是執(zhí)行它，所以它是啟動文件；在腳本中包含歸檔文件時就像包含普通php文件一樣包含它并運(yùn)行，但直接以phar://的方式包含歸檔中某一個文件時不會執(zhí)行存根代碼， 往往在存根文件里面require包含要運(yùn)行的其他文件，對存根文件的限制僅為以__HALT_COMPILER();結(jié)束，默認(rèn)的存根設(shè)計是為在沒有phar擴(kuò)展時能夠運(yùn)行，它提取phar文件內(nèi)容到一個臨時目錄再執(zhí)行，不過從php5.3開始該擴(kuò)展默認(rèn)內(nèi)置啟用了
4、制作的phar文件不能被改動，因此配置文件之類的文件需要另外放置在歸檔文件外面
5、mapPhar函數(shù)：這個函數(shù)只應(yīng)該在stub存根代碼中調(diào)用，在沒有設(shè)置歸檔別名的時候可以用來設(shè)置別名，打開一個引用映射到phar流
更多關(guān)于PHP相關(guān)內(nèi)容感興趣的讀者可查看本站專題：《PHP基本語法入門教程》、《PHP運(yùn)算與運(yùn)算符用法總結(jié)》、《php面向?qū)ο蟪绦蛟O(shè)計入門教程》、《PHP網(wǎng)絡(luò)編程技巧總結(jié)》、《php字符串(string)用法總結(jié)》、《php+mysql數(shù)據(jù)庫操作入門教程》及《php常見數(shù)據(jù)庫操作技巧匯總》
希望本文所述對大家PHP程序設(shè)計有所幫助。
相關(guān)文章
這篇文章主要介紹了php類的自動加載操作,結(jié)合實例形式詳細(xì)分析了php類的自動加載操作相關(guān)函數(shù)與實現(xiàn)技巧,需要的朋友可以參考下2016-09-09
在?Web?開發(fā)中,處理日期和時間是一個常見的任務(wù),PHP?提供了一系列強(qiáng)大的日期和時間處理函數(shù),下面我們就來看看這些函數(shù)的用法和優(yōu)勢吧2023-08-08
本篇文章是對dedecms空間遷移步驟進(jìn)行了詳細(xì)的分析介紹，需要的朋友參考下2013-05-05
本篇文章是對PHP中的函數(shù)foreach()的用法進(jìn)行了詳細(xì)的分析介紹，需要的朋友參考下2013-06-06
php讀取文件內(nèi)容至字符串中，同時去除換行、空行、行首行尾空格（Zjmainstay原創(chuàng)）
讀取文件內(nèi)容至字符串中，同時去除換行、行首行尾空格,原理不錯，需要的朋友可以參考下2012-07-07
這篇文章主要介紹了PHP中STDCLASS用法,結(jié)合實例形式分析了PHP中STDCLASS的功能、原理、使用方法與相關(guān)注意事項,需要的朋友可以參考下2016-11-11
這篇文章主要介紹了php生成excel列名超過26列大于Z時的解決方法,是針對采用PHPExcel生成excel列數(shù)過多的情況下的完善技巧,具有一定的參考借鑒價值,需要的朋友可以參考下2014-12-12
本篇文章是對php插件 HTMLPurifier HTML解析器進(jìn)行了詳細(xì)的分析介紹，需要的朋友參考下2013-07-07
WordPress中調(diào)試縮略圖的相關(guān)PHP函數(shù)使用解析
這篇文章主要介紹了WordPress中調(diào)試縮略圖的相關(guān)PHP函數(shù)使用解析,包括使用set_post_thumbnail_size來調(diào)整縮略圖的大小,需要的朋友可以參考下2016-01-01
這篇文章主要介紹了php查看當(dāng)前Session的ID的方法,實例分析了兩種常見的獲取session中ID的技巧,非常具有實用價值,需要的朋友可以參考下2015-03-03