溫馨提示×

您好，登錄后才能下訂單哦！

密碼登錄×
登錄注冊(cè)×
其他方式登錄
點(diǎn)擊 登錄注冊(cè) 即表示同意《億速云用戶服務(wù)條款》

PHP的phar怎么創(chuàng)建

發(fā)布時(shí)間：2022-04-22 13:39:32 來(lái)源：億速云 閱讀：230 作者：iii 欄目：編程語(yǔ)言

這篇文章主要介紹“PHP的phar怎么創(chuàng)建”的相關(guān)知識(shí)，小編通過(guò)實(shí)際案例向大家展示操作過(guò)程，操作方法簡(jiǎn)單快捷，實(shí)用性強(qiáng)，希望這篇“PHP的phar怎么創(chuàng)建”文章能幫助大家解決問(wèn)題。

PHP的phar怎么創(chuàng)建

一  phar文件是什么

Jar（Java Archive）文件，一個(gè)應(yīng)用，包括所有的可執(zhí)行，可訪問(wèn)的文件，都打包進(jìn)了一個(gè)JAR文件里，使得部署過(guò)程十分簡(jiǎn)單。

類似于JAR。phar全稱為PHP Archive，phar擴(kuò)展提供了一種將整個(gè)PHP應(yīng)用程序放入.phar文件中的方法，以方便移動(dòng)、安裝。phar文件的最大特點(diǎn)是將幾個(gè)文件組合成一個(gè)文件的便捷方式。.phar文件提供了一種將完整的PHP程序分布在一個(gè)文件中并從該文件中運(yùn)行的方法。

與 JAR 不同的是Phar 可由 PHP 本身處理，因此不需要使用額外的工具來(lái)創(chuàng)建或使用，使用php腳本就能創(chuàng)建或提取它。

phar文件有三種格式：tar歸檔、zip歸檔、phar歸檔，前兩種執(zhí)行需要php安裝Phar 擴(kuò)展支持，用的也比較少，這里主要講phar歸檔格式。

二  phar的創(chuàng)建

1  修改php.ini配置文件

PHAR文件缺省狀態(tài)是只讀的，使用Phar文件不需要任何的配置。部署非常方便。因?yàn)槲覀儸F(xiàn)在需要?jiǎng)?chuàng)建一個(gè)自己的Phar文件，所以需要允許寫入Phar文件，這需要修改一下 php.ini

我的php.ini文件中，phar.readonly = On。

[Phar]
; http://php.net/phar.readonly
;phar.readonly = On

首先在php.ini中修改phar.readonly這個(gè)選項(xiàng)，去掉前面的分號(hào)，并改值為off，由于安全原因該選項(xiàng)默認(rèn)是on，如果在php.ini中是禁用的（值為0或off），那么在用戶腳本中可以開(kāi)啟或關(guān)閉，如果在php.ini中是開(kāi)啟的，那么用戶腳本是無(wú)法關(guān)閉的，所以這里設(shè)置為off來(lái)展示示例。

現(xiàn)在，我們就可以來(lái)把PHP應(yīng)用打包成Phar文件了。

2  創(chuàng)建我們自己的PHP文件項(xiàng)目

這里我都是借助別人博客的項(xiàng)目直接Copy的，并沒(méi)有進(jìn)行演示，因?yàn)槲艺肀酒┛偷某踔允菫榱私鈖har://漏洞打ctf的。所以其中的文件名就按照原作者的不進(jìn)行修改了。最后會(huì)加上參考文章的。

首先我要按按照一個(gè)的規(guī)則創(chuàng)建應(yīng)用的目錄結(jié)構(gòu)，根目錄為project，project下的目錄如下面這樣：

file
    -yunek.js
    -yunke.css
lib
    -lib_a.php
template
    -msg.html
index.php
Lib.php

其中file文件夾有兩個(gè)內(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()";
}

3  創(chuàng)建phar文件

項(xiàng)目文件準(zhǔn)備好了，現(xiàn)在在project文件夾同級(jí)目錄建立一個(gè)yunkeBuild.php，用于產(chǎn)生phar格式文件，內(nèi)容如下：

<?php
/**
 * Created by yunke.
 * User: yunke
 * Date: 2017/2/10
 * Time: 9:36
 */
 
//產(chǎn)生一個(gè)yunke.phar文件
$phar = new Phar('yunke.phar', 0, 'yunke.phar');
// 添加project里面的所有文件到y(tǒng)unke.phar歸檔文件
$phar->buildFromDirectory(dirname(__FILE__) . '/project');
//設(shè)置執(zhí)行時(shí)的入口文件，第一個(gè)用于命令行，第二個(gè)用于瀏覽器訪問(wèn)，這里都設(shè)置為index.php
$phar->setDefaultStub('index.php', 'index.php');

然后在瀏覽器中訪問(wèn)這個(gè)yunkeBuild.php文件，將產(chǎn)生一個(gè)yunke.phar文件，此時(shí)服務(wù)器根目錄結(jié)構(gòu)如下：

project

yunkeBuild.php

yunke.phar

這就是產(chǎn)生一個(gè)phar歸檔文件最簡(jiǎn)單的過(guò)程了。

這里我再做一些其他的補(bǔ)充，方便更好的理解：

1）phar文件的產(chǎn)生是通過(guò)訪問(wèn)yunkeBuild.php，相當(dāng)于執(zhí)行。因此可以在終端執(zhí)行如下代碼產(chǎn)生

aabouzekry@platinum:~/myapp$ php yunkeBuild.php

然后就產(chǎn)生了yunke.phar文件。

2）new phar（）產(chǎn)生phar對(duì)象。對(duì)其中的參數(shù)進(jìn)行一下解讀。

<?php
$phar = new Phar("/yunke.phar", 
        FilesystemIterator::CURRENT_AS_FILEINFO |
        FilesystemIterator::KEY_AS_FILENAME, "yunke.phar");

解釋：

一個(gè)新 Phar 對(duì)象的創(chuàng)建通常需要三個(gè)參數(shù)。

第一個(gè)參數(shù)是Phar文件的路徑。你不僅可以通過(guò)它創(chuàng)建Phar文件，還可以對(duì)現(xiàn)存的Phar文件進(jìn)行操作。

第二個(gè)參數(shù)是設(shè)定 Phar 對(duì)象如何處理文件。Phar 對(duì)象繼承了 PHP RecursiveDirectoryIterator 對(duì)象，這個(gè)參數(shù)是直接傳遞到父類里。這里提供的值是RecursiveDirectoryIterator 的缺省值，能滿足目前的要求。

第三個(gè)參數(shù)是Phar文件的別名，在內(nèi)部引用這個(gè)Phar文件時(shí)都要使用這個(gè)別名。

通常只需傳入文件名。也就是第三個(gè)參數(shù)。

3） 往phar中添加文件。添加文件有幾種如下方法：

  • 手動(dòng)添加已有文件

調(diào)用類方法Phar::addFile($filepath,$localpath=?)添加文件，參數(shù)是文件絕對(duì)路徑和（可選）存儲(chǔ)到phar的相對(duì)路徑

<?php
	$phar = new Phar('yunke.phar');
	$phar->addFile('test.php');
	include('phar://yunke.phar/test.php') // in test.php
?>

這里出現(xiàn)的phar：//就是訪問(wèn)phar文件的一種方法，所以不需要太在意。

  • 以字符串添加文件內(nèi)容

調(diào)用類方法Phar::addFromString($localpath,$contents)以字符串形式添加文件

<?php
	$phar = new Phar('yunke.phar');
	$phar->addFromString('test.php','<?php echo \'in test.php\'?>');
	include('phar://yunke.phar/test.php'); // in test.php
?>

  • 添加空目錄

調(diào)用類方法Phar::addEmptyDir($dirname)添加空目錄，使用方法Phar::getContent()獲取文件結(jié)構(gòu)

<?php
	$phar = new Phar('yunke.phar');
	$phar->addEmptyDir('test'); // yunke.phar/test/
?>

  • 手動(dòng)選擇添加已有目錄

調(diào)用類方法Phar::buildFromDirectory($dir,$pattern = "")添加整個(gè)目錄

<?php
	$phar = new Phar('yunke.phar');
	$phar->buildFromDirectory('test'); // test.php in test/
	include('phar://yunke.phar/test/test.php'); // in test/test.php
?>

4） 存根文件Stub，理解這個(gè)很重要。

歸檔文件中有一個(gè)存根文件stub，其實(shí)就是一段php執(zhí)行代碼，在制作歸檔時(shí)可以設(shè)置，直接執(zhí)行歸檔文件時(shí)，其實(shí)就是執(zhí)行它，所以它是啟動(dòng)文件；在腳本中包含歸檔文件時(shí)就像包含普通php文件一樣包含它并運(yùn)行，但直接以phar://的方式包含歸檔中某一個(gè)文件時(shí)不會(huì)執(zhí)行存根代碼， 往往在存根文件里面require包含要運(yùn)行的其他文件，對(duì)存根文件的限制僅為以__HALT_COMPILER(); 結(jié)束，默認(rèn)的存根設(shè)計(jì)是為在沒(méi)有phar擴(kuò)展時(shí)能夠運(yùn)行，它提取phar文件內(nèi)容到一個(gè)臨時(shí)目錄再執(zhí)行，不過(guò)從php5.3開(kāi)始該擴(kuò)展默認(rèn)內(nèi)置啟用了。

stub是phar文件的文件頭，格式為...<?php ...;__HALT_COMPILER();?>，…可以是任意字符，包括留空，且php閉合符與最后一個(gè)分號(hào)之間不能有多于一個(gè)的空格符。另外php閉合符也可省略。最短省略閉合符的stub是<?php __HALT_COMPILER();?>

運(yùn)行Phar文件時(shí)，stub文件被當(dāng)做一個(gè)meta文件來(lái)初始化Phar， 并告訴Phar文件在被調(diào)用時(shí)該做什么。

在我們的例子中，使用的是 createDefaultStub() 方法。

其他的方式如下:

方法一：調(diào)用類方法Phar::setStub($string)為實(shí)例創(chuàng)建自定義stub

<?php
	$phar = new Phar('yunke.phar');
	$phar->setStub('<?php echo \'in stub!\';__HALT_COMPILER();?>');
	include('phar://yunke.phar');	// in stub!
?>

也可以

$phar->setStub($phar->createDefaultStub("index.php"));

生成的缺省stub文件包含如下的代碼：

<?php
Phar::mapPhar();
include "phar://yunke.phar/index.php";
__HALT_COMPILER();

createDefaultStub() 方法缺省創(chuàng)建的stub文件的內(nèi)容很簡(jiǎn)單。 Phar::mapPhar() 用來(lái)分析Phar文件的元數(shù)據(jù)，并初始化它。stub文件的結(jié)尾處需要調(diào)用 __HALT_COMPILER() 方法，這個(gè)方法后不能留空格。__HALT_COMPILER() 會(huì)立即終止PHP的運(yùn)行，防止include的文件在此方法后仍然執(zhí)行。這是Phar必須的，沒(méi)有它Phar將不能正常運(yùn)行。

除此之外，我們還可以創(chuàng)建自己的stub文件來(lái)執(zhí)行自定義的初始化過(guò)程，像這樣加載自定義文件

<?php
$phar->setStub(file_get_contents("stub.php"));

方法二：使用默認(rèn)stub，調(diào)用類方法Phar::setDefaultStub()為實(shí)例設(shè)置默認(rèn)stub，使用方法Phar::getStub()獲取實(shí)例的stub

<?php
    $phar = new Phar('yunke.phar');
    $phar->setDefaultStub();
    print_r($phar->getStub()); // 2, 'c' => 'text/plain', 'cc' => 'text/plain', ...
?>

如果缺省創(chuàng)建stub，PHP會(huì)使用默認(rèn)stub

<?php
	$phar = new Phar('yunke.phar');
	$phar['demo.txt'] = 'demo';
	print_r($phar->getStub()); // 2, 'c' => 'text/plain', 'cc' => 'text/plain', ...
?>

4 phar文件的運(yùn)行

我們?cè)诜?wù)器根目錄建立一個(gè)index.php文件來(lái)演示如何使用上面創(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文件中只有第一行，那么和不使用歸檔文件時(shí)，添加如下代碼完全相同：

require "project/index.php";

如果沒(méi)有第二行，那么第三行的yunke()將提示未定義，所以可見(jiàn)require一個(gè)phar文件時(shí)并不是導(dǎo)入了里面所有的文件，而只是導(dǎo)入了入口執(zhí)行文件而已，但在實(shí)際項(xiàng)目中往往在這個(gè)入口文件里導(dǎo)入其他需要使用的文件，在本例中入口執(zhí)行文件為project/index.php。

補(bǔ)充：

可以為歸檔設(shè)置別名，別名保存在歸檔文件中永久保存，它可以用一個(gè)簡(jiǎn)短的名字引用歸檔，而不管歸檔文件在文件系統(tǒng)中存儲(chǔ)在那里，設(shè)置別名：

$phar = new Phar('lib/yunke.phar', 0);
$phar->setAlias ( "yun.phar");

設(shè)置別名后可以如下使用：

<?php
require "lib/yunke.phar";
require "phar://yun.phar/Lib.php";  //使用別名訪問(wèn)歸檔文件
require "phar://lib/yunke.phar/Lib.php"; //當(dāng)然仍然可以使用這樣的方式去引用

如果在制作phar文件時(shí)沒(méi)有指定別名，也可以在存根文件里面使用Phar::mapPhar('yunke.phar');指定。

5 phar文件的提取還原

我們有時(shí)候會(huì)好奇phar里面包含的文件源碼，這個(gè)時(shí)候就需要將phar文件還原，如果只是看一看的話可以使用一些ide工具，比如phpstorm 10就能直接打開(kāi)它，如果需要修改那么就需要提取操作了，為了演示，我們下載一個(gè)composer.phar放在服務(wù)器目錄，在根目錄建立一個(gè)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'); //提取一份原項(xiàng)目文件
$phar->convertToData(Phar::ZIP); //另外再提取一份，和上行二選一即可

用瀏覽器訪問(wèn)這個(gè)文件，即可提取出來(lái)，以上列子展示了兩種提取方式：

第二行將建立一個(gè)composer目錄，并將提取出來(lái)的內(nèi)容放入；

第三行將產(chǎn)生一個(gè)composer.zip文件，解壓即可得到提取還原的項(xiàng)目文件。

關(guān)于“PHP的phar怎么創(chuàng)建”的內(nèi)容就介紹到這里了，感謝大家的閱讀。如果想了解更多行業(yè)相關(guān)的知識(shí)，可以關(guān)注億速云行業(yè)資訊頻道，小編每天都會(huì)為大家更新不同的知識(shí)點(diǎn)。

向AI問(wèn)一下細(xì)節(jié)

免責(zé)聲明：本站發(fā)布的內(nèi)容（圖片、視頻和文字）以原創(chuàng)、轉(zhuǎn)載和分享為主，文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng)，如果涉及侵權(quán)請(qǐng)聯(lián)系站長(zhǎng)郵箱：is@yisu.com進(jìn)行舉報(bào)，并提供相關(guān)證據(jù)，一經(jīng)查實(shí)，將立刻刪除涉嫌侵權(quán)內(nèi)容。

AI
助
手