存档

文章标签 ‘phar归档文件’

phar简介

2016年11月30日 没有评论

php5.3以后有一个非常不错的特性phar，有些类似java中的jar包，就是可以把php应用程序打包到一个单独的phar归档文件中。其实这个特性以前很早貌似就用，只不过最早是用php写的，所以性能上面不是特别好，后面官方用c扩展重新写一遍，文档可以查看Phar文档，不过目前90%的内容是英文的，下面我对介绍进行了一点简单翻译,当然英语水平一般，错误之处欢迎指正啊。

Phar简介

Phar扩展提供了一种将整个php应用放入一个单独文件被称为”phar”的归档，包更容易的发布和安装的解决方案。除了提供这种服务，phar扩展也提供了一种抽象化的文件格式的方法来创建和管理tar或者zip文件通过PharData类，很像Pdo提供了一种统一的接口来访问不同的数据库。和PDO不同之处，Pdo不能将数据在不同的数据库之间转换，Phar可以通过一行代码就可以在tar,zip和phar之间转换文件格式。查看Phar::convertToExecutable()示例。

phar是什么？phar归档文件最显著的特征是组合很多文件文件到一个单独的文件中。就像这样，一个phar文档提供了一种方式来发布一个完成的php应用程序在一个单独的文件中并且可以通过这个文件来运行它而无需解压到硬盘上。此外，phar归档文件也可以像其他php文件一样去被PHP执行，同时可以通过命令行和一台web服务器。Phar就像一种为PHP应用程序设计的拇指驱动器（U盘）。

Phar实现这些功能通过Stream Wrapper。一般来说，要使用一个在Phar归档中的php脚本文件，你可以用include。

函数介绍

可以参考另一篇关于phar函数手册的博客。

简单案例

这是一个比较简单的demo，希望通过这个能对phar有个比较初步的了解。

目录树如下：

|____build.php
|____config.json
|____extractPhar.php
|____lib
| |____class
| | |____empty.txt
| |____func.php
| |____stub.php
|____phar.phar
|____test_phar.php

build.php为生成phar归档文件的php脚本，config.json文件其实没什么用，extractPhar.php为解压phar到指定目录的脚本，lib目录下面就是测试用的库函数，phar.phar是用build.php生成的归档文件，test_phar.php是测试phar归档文件的脚本。下面我们一个一个的介绍这里面涉及到的脚本文件。

[build.php]

</pre>
<pre><?php</pre>
<pre>try{
    $phar = new Phar('phar.phar',0,'my.phar');
    $phar->buildFromDirectory(__DIR__.'/lib/');
    //$phar->buildFromDirectory(__DIR__.'/lib/',"/\.php/");
    $phar->addFile("config.json","config");
    $phar->setDefaultStub('stub.php','stub.php');
    $phar->compressFiles(Phar::GZ);
}catch (Exception $e){
    echo $e->getMessage();
}</pre>
<pre>

这里需要注意把php.ini 中的 phar.readonly 设为 0 以适合 Phar 对象. 否则, 将抛出PharException。

[func.php]

</pre>
<pre>function println($str){
    echo $str."\n";
}

function myFunc($input=__FILE__){
    println('Input File:'.$input);
    println('File Path:'.__DIR__);
}</pre>
<pre>

[stub.php]

</pre>
<pre><?php

require_once 'func.php';
myFunc(__FILE__);</pre>
<pre>

[test_phar.php]

</pre>
<pre><?php
include_once 'phar.phar';
include_once 'phar://my.phar/func.php';
myFunc(__FILE__);
$content = file_get_contents("phar://my.phar/config");
println($content);</pre>
<pre>

[extractPhar.php]

</pre>
<pre><?php
$phar = new Phar('phar.phar');
$phar->extractTo('./extract/');</pre>
<pre>

通过命令行脚本执行”php build.php”可以生成phar.phar归档文件。可以直接用”php phar.phar”执行phar归档文件，
它会执行”setDefaultStub”设置stub文件。extractPhar.php会将phar.phar归档文件中的内容解压到extract目录下面，
方面我们查看phar归档中的内容。
test_phar.php的执行结果如下：

Input File:phar:///Users/king/www/test/Phar/phar.phar/stub.php
File Path:phar:///Users/king/www/test/Phar/phar.phar
Input File:/Users/king/www/test/Phar/test_phar.php
File Path:phar:///Users/king/www/test/Phar/phar.phar
{
 "name" : "phar test project",
 "path" : "~/www/test/Phar"
}

extractPhar.php解压的extract目录如下：
|____class
| |____empty.txt
|____config
|____func.php
|____stub.php
分类: PHP 标签: , ,