Hyperf Phar 打包性能优化实践

背景介绍

在 PHP 应用开发中，Phar 打包是一种常见的部署方式。Hyperf 作为高性能 PHP 框架，其官方 Phar 打包工具在实际使用中遇到了显著的性能问题。本文将详细介绍如何通过优化 Phar 打包流程，将打包时间从原来的 25 分钟缩短到不足 1 分钟。

问题分析

传统 Phar 打包方式存在的主要性能瓶颈在于：

1. 文件逐个写入 Phar 包导致大量 I/O 操作
2. 频繁的文件系统访问增加了打包时间
3. 缺乏有效的缓存机制

这些问题在大型项目中尤为明显，当项目包含数千个文件时，打包时间会呈指数级增长。

优化方案

我们设计了一个 CustomPhar 类来解决这些问题，主要优化点包括：

1. 引入临时目录缓存

创建一个临时目录作为文件缓存区，所有待打包文件先复制到该目录，最后统一打包。这种方式减少了 Phar 包的频繁写入操作。

private string $tempDir;

public function __construct(string $filename, int $flags = \FilesystemIterator::SKIP_DOTS | \FilesystemIterator::UNIX_PATHS, ?string $alias = null)
{
    parent::__construct($filename, $flags, $alias);
    $this->tempDir = sys_get_temp_dir() . '/phar_cache_' . uniqid();
    $this->createDirectory($this->tempDir);
}

2. 批量文件处理

重写关键方法，将所有文件操作改为先缓存到临时目录：

public function addFile(string $filename, ?string $localName = null): void
{
    $localName = $localName ?? basename($filename);
    $relativePath = $this->tempDir . '/' . $localName;
    $this->createDirectory(dirname($relativePath));
    copy($filename, $relativePath);
}

public function addFromString(string $localName, string $contents): void
{
    $relativePath = $this->tempDir . '/' . $localName;
    $this->createDirectory(dirname($relativePath));
    file_put_contents($relativePath, $contents);
}

3. 目录递归复制优化

实现高效的目录递归复制功能，支持可选的文件名模式匹配：

private function recursiveCopy(string $source, string $destination, ?string $pattern = null): void
{
    $iterator = new \RecursiveIteratorIterator(
        new \RecursiveDirectoryIterator($source, \FilesystemIterator::SKIP_DOTS),
        \RecursiveIteratorIterator::SELF_FIRST
    );

    foreach ($iterator as $item) {
        $targetPath = $destination . '/' . substr($item->getRealPath(), strlen($source) + 1);
        if ($item->isDir()) {
            $this->createDirectory($targetPath);
        } elseif (!$pattern || preg_match($pattern, $item->getFilename())) {
            copy($item->getRealPath(), $targetPath);
        }
    }
}

4. 最终打包操作

所有文件准备就绪后，执行一次性打包操作：

public function save(): void
{
    parent::buildFromDirectory($this->tempDir);
    $this->clearTempDir();
}

实现效果

经过上述优化后：

1. 打包时间从 25 分钟缩短到不足 1 分钟
2. 系统资源占用显著降低
3. 打包过程更加稳定可靠

技术要点

1. 临时目录策略：利用系统临时目录作为中间缓存，避免频繁的 Phar 写入操作
2. 批量处理：收集所有文件后再统一打包，减少 I/O 操作次数
3. 递归复制优化：高效处理大型目录结构
4. 资源清理：打包完成后自动清理临时文件

总结

通过对 Phar 打包流程的重新设计，我们成功解决了 Hyperf 框架 Phar 打包的性能瓶颈问题。这种优化思路不仅适用于 Hyperf，也可以为其他 PHP 项目的 Phar 打包优化提供参考。关键点在于减少直接操作 Phar 包的次数，通过中间缓存实现批量处理，从而显著提升打包效率。