您好，登录后才能下订单哦！
密码登录
登录注册
点击 登录注册 即表示同意《亿速云用户服务条款》
# PHP用Phar代码打包工具的方法
## 一、Phar概述
### 1.1 什么是Phar
Phar（PHP Archive）是PHP 5.3及以上版本中内置的打包工具，它允许开发者将多个PHP文件、资源文件以及元数据打包成单个归档文件。Phar扩展名源自"PHP Archive"的缩写，类似于Java的JAR文件或.NET的DLL文件。
Phar的主要特点包括：
- 将整个PHP应用程序打包为单个文件
- 支持gzip和bzip2压缩
- 内置文件格式验证
- 支持数字签名验证
- 可通过流包装器直接访问内部文件
### 1.2 Phar的优势
使用Phar打包PHP代码具有以下显著优势：
1. **部署简便**：只需分发一个文件而非整个目录结构
2. **版本管理**：便于版本控制和更新
3. **性能提升**：减少文件系统操作，提高加载速度
4. **安全性**：支持签名验证，防止篡改
5. **资源整合**：可将配置文件、模板等资源一并打包
### 1.3 Phar的应用场景
Phar特别适用于以下场景：
- 命令行工具分发（如Composer）
- 微服务架构中的独立模块
- 需要频繁部署的应用程序
- 包含大量资源文件的Web应用
- 需要保护源代码的商业软件
## 二、环境准备
### 2.1 PHP版本要求
Phar需要PHP 5.3.0或更高版本，但建议使用PHP 7.0+以获得更好的性能和安全性。要检查PHP是否支持Phar，可以运行：
```php
<?php
phpinfo();
在输出中搜索”Phar”扩展，或直接运行：
php -m | grep phar
在大多数现代PHP发行版中，Phar扩展默认已启用。如果未启用，需要在php.ini中取消以下行的注释：
extension=phar
对于Windows系统，可能需要指定扩展文件：
extension=php_phar.dll
为确保Phar正常工作，建议检查以下php.ini设置：
; 允许执行Phar文件
phar.readonly = Off
; 设置Phar缓存大小（可选）
phar.cache_list =
注意：生产环境中应将phar.readonly设为On以提高安全性，仅在创建Phar时临时设为Off。
以下是创建Phar文件的基本步骤：
<?php
// 创建Phar对象
$phar = new Phar('myapp.phar');
// 开始缓冲Phar写入操作
$phar->startBuffering();
// 添加项目文件
$phar->buildFromDirectory('/path/to/project', '/\.php$/');
// 设置执行入口
$phar->setDefaultStub('index.php');
// 结束缓冲并写入磁盘
$phar->stopBuffering();
buildFromDirectory方法可以方便地将整个目录添加到Phar中：
$phar->buildFromDirectory(
'/path/to/source',
'/\.(php|txt|json|xml|css|js|png|jpg)$/'
);
第二个参数是正则表达式，用于匹配需要包含的文件类型。
对于更精细的控制，可以使用addFile和addFromString方法：
// 添加单个文件
$phar->addFile('/path/to/config.ini', 'config.ini');
// 从字符串添加文件内容
$phar->addFromString('version.txt', '1.0.0');
存根是Phar文件的入口点，相当于可执行文件的main函数：
// 简单存根
$phar->setStub('<?php __HALT_COMPILER(); ?>');
// 带自动加载的存根
$stub = <<<'EOT'
<?php
Phar::mapPhar('myapp.phar');
require 'phar://myapp.phar/bootstrap.php';
__HALT_COMPILER();
EOT;
$phar->setStub($stub);
Phar支持Gzip和Bzip2压缩：
// Gzip压缩
$phar->compress(Phar::GZ);
// Bzip2压缩
$phar->compress(Phar::BZ2);
注意：压缩后原始.phar文件会被替换为.phar.gz或.phar.bz2。
一个典型的Phar文件内部结构如下：
/phar-root
├── META-INF/
│ └── manifest.xml
├── src/
│ ├── Class1.php
│ └── Class2.php
├── vendor/
│ └── autoload.php
├── resources/
│ ├── config.ini
│ └── logo.png
└── index.php
Phar可以存储自定义元数据：
// 设置元数据
$phar->setMetadata([
'version' => '1.0.1',
'author' => 'John Doe',
'build_date' => date('Y-m-d')
]);
// 获取元数据
$metadata = $phar->getMetadata();
Phar支持SHA-1、SHA-256和SHA-512签名：
// 使用SHA-256签名
$privateKey = file_get_contents('private.pem');
$phar->setSignatureAlgorithm(Phar::SHA256, $privateKey);
// 验证签名
try {
$phar->getSignature();
} catch (Exception $e) {
echo "签名验证失败: " . $e->getMessage();
}
打包后的Phar文件可以直接在命令行中执行：
php myapp.phar
或添加可执行权限后直接运行：
chmod +x myapp.phar
./myapp.phar
在Web应用中使用Phar：
<?php
require 'phar:///path/to/myapp.phar/index.php';
或通过别名配置：
Alias /myapp /path/to/myapp.phar
Phar实现了流包装器，可以像访问普通文件系统一样访问内部文件：
$content = file_get_contents('phar://myapp.phar/config/settings.ini');
在Phar中实现PSR-4自动加载：
$phar->addFromString('src/Autoloader.php', '
<?php
spl_autoload_register(function ($class) {
$file = "phar://" . __FILE__ . "/src/"
. str_replace("\\", "/", $class) . ".php";
if (file_exists($file)) {
require $file;
}
});
');
将Composer依赖打包到Phar中：
composer install --no-dev
$phar->buildFromDirectory('/path/to/project', '/\.(php|json)$/');
require 'phar://myapp.phar/vendor/autoload.php';
对于大型资源文件，可以条件性地解压到临时目录：
$resourcePath = 'phar://myapp.phar/resources/large.dat';
$tempFile = sys_get_temp_dir().'/large_'.md5_file($resourcePath).'.dat';
if (!file_exists($tempFile)) {
copy($resourcePath, $tempFile);
}
实现Phar自更新功能：
function selfUpdate() {
$latest = file_get_contents('https://example.com/latest.phar');
file_put_contents(__FILE__, $latest);
}
使用OpenSSL创建签名：
# 生成私钥
openssl genrsa -out private.pem 4096
# 生成公钥
openssl rsa -in private.pem -pubout -out public.pem
在代码中验证签名：
$pubKey = openssl_pkey_get_public('file://public.pem');
$signature = $phar->getSignature();
if (openssl_verify(
file_get_contents($phar->getPath()),
$signature['hash'],
$pubKey,
$signature['hash_type']
)) {
echo "验证通过";
}
确保存根代码安全：
$stub = '<?php
if (basename(__FILE__) == basename($_SERVER["SCRIPT_NAME"])) {
Phar::webPhar();
} else {
// 防止直接访问内部文件
exit;
}
__HALT_COMPILER();';
设置适当的文件权限：
// 创建后设置权限
chmod('myapp.phar', 0755);
// 内部文件权限
$phar->addFromString('config.ini', $config, 0644);
“phar.readonly cannot be disabled”：
phar.readonly=Offphp -d phar.readonly=0 build.php“Unable to open phar for reading”：
“Invalid stub”：
__HALT_COMPILER();<?print_r(new Phar('myapp.phar'));
var_dump(file_exists('phar://myapp.phar/src/Class.php'));
php -a
Interactive shell
php > $p = new Phar('myapp.phar');
php > print_r($p->getMetadata());
使用Blackfire进行性能分析：
blackfire run php myapp.phar
或使用XHProf：
xhprof_enable();
require 'phar://myapp.phar';
$xhprof_data = xhprof_disable();
以CLI工具为例的完整打包脚本：
#!/usr/bin/env php
<?php
try {
$pharFile = 'console-tool.phar';
// 清理旧文件
if (file_exists($pharFile)) {
unlink($pharFile);
}
$phar = new Phar($pharFile);
$phar->startBuffering();
// 添加项目文件
$phar->buildFromIterator(
new RecursiveIteratorIterator(
new RecursiveDirectoryIterator(__DIR__.'/src')
),
__DIR__
);
// 添加vendor目录
$phar->buildFromDirectory(__DIR__.'/vendor');
// 设置存根
$stub = '#!/usr/bin/env php
<?php
Phar::mapPhar("console-tool.phar");
require "phar://console-tool.phar/vendor/autoload.php";
require "phar://console-tool.phar/src/Console.php";
__HALT_COMPILER();';
$phar->setStub($stub);
$phar->stopBuffering();
chmod($pharFile, 0755);
echo "成功构建 $pharFile\n";
} catch (Exception $e) {
echo "构建失败: ".$e->getMessage()."\n";
exit(1);
}
Web应用打包示例：
$phar = new Phar('webapp.phar', 0, 'webapp.phar');
$phar->startBuffering();
// 添加核心文件
$phar->addFile('index.php', 'web/index.php');
$phar->addFile('router.php', 'web/router.php');
// 添加静态资源
$phar->buildFromDirectory('assets/', '/\.(css|js|png|jpg)$/');
// 设置元数据
$phar->setMetadata([
'entryPoint' => 'web/index.php',
'environment' => 'production'
]);
// 设置存根
$phar->setStub('<?php
Phar::webPhar("webapp.phar", "web/index.php");
echo "无法通过web访问";
__HALT_COMPILER();');
$phar->stopBuffering();
微服务打包配置：
$phar = new Phar('service.phar');
$phar->startBuffering();
// 添加服务代码
$phar->buildFromDirectory(__DIR__.'/service', '/\.php$/');
// 添加协议文件
$phar->addFile(__DIR__.'/proto/service.proto');
// 设置GRPC存根
$stub = '<?php
require_once "phar://service.phar/vendor/autoload.php";
$server = new \Service\Implementation();
$server->start();
__HALT_COMPILER();';
$phar->setStub($stub);
$phar->stopBuffering();
推荐的项目结构：
/project-root
├── build/ # 构建脚本
├── src/ # 源代码
├── resources/ # 资源文件
├── tests/ # 测试代码
├── vendor/ # 依赖库
├── phar/ # 输出目录
├── composer.json # 依赖配置
└── build.php # Phar构建脚本
.phar文件加入.gitignoreapp-1.2.3.pharGitLab CI示例：
build_phar:
stage: build
script:
- composer install --no-dev
- php -d phar.readonly=0 build.php
artifacts:
paths:
- build/output/app.phar
DIRECTORY_SEPARATOR代替/或\\n而非平台相关行尾| 特性 | Phar | Zip |
|---|---|---|
| PHP集成度 | 原生支持 | 需要扩展 |
| 执行能力 | 可直接执行 | 需解压后执行 |
| 压缩算法 | gzip, bzip2 | 多种压缩算法 |
| 流包装器 | 内置支持 | 需要额外处理 |
| 元数据 | 丰富支持 | 有限支持 |
| 特性 | Phar | Docker |
|---|---|---|
| 打包粒度 | 代码级别 | 系统级别 |
| 依赖管理 | 仅PHP | 全系统 |
| 启动速度 | 快 | 较慢 |
| 隔离性 | 弱 | 强 |
| 适用场景 | CLI/PHP应用 | 复杂系统 |
PHP 8对Phar的改进： - 更好的JIT兼容性 - 改进的错误处理 - 性能优化
Phar在Serverless环境中的应用： - 作为AWS Lambda层 - Azure Functions部署包 - Google Cloud Functions
值得关注的工具： - Box：增强的Phar构建工具 - PharBuilder：GUI构建工具 - PharComposer：Composer集成工具
Phar作为PHP生态中强大的打包工具，为代码分发和部署提供了高效解决方案。通过本文介绍的方法和最佳实践，开发者可以充分利用Phar的优势，构建更易维护和分发的PHP应用程序。随着PHP语言的持续发展，Phar工具链也将不断进化，在云原生时代继续
免责声明：本站发布的内容（图片、视频和文字）以原创、转载和分享为主，文章观点不代表本网站立场，如果涉及侵权请联系站长邮箱：is@yisu.com进行举报，并提供相关证据，一经查实，将立刻删除涉嫌侵权内容。