1. 项目概述从“打包”到“分发”重新认识PHP的PHAR如果你写过一段时间的PHP尤其是开发过需要分发给别人使用的库、工具或者命令行应用那你大概率经历过这样的烦恼一个项目依赖了十几个甚至几十个Composer包最终交付时你需要把整个vendor目录、你自己的源代码、配置文件一股脑地打包成一个ZIP文件发给用户。用户拿到手后解压、配置、设置权限步骤繁琐不说还容易因为环境差异导致各种“玄学”问题。更头疼的是如果你的工具本身就是一个独立的、希望用户能像composer或phpunit那样直接通过命令行调用的脚本这种分发方式就显得非常笨重。PHARPHP Archive就是为了解决这个痛点而生的。你可以把它理解成PHP世界的“可执行JAR包”或“自包含的应用程序”。它能把整个PHP项目包括代码、依赖、静态资源打包成一个单一的.phar文件。这个文件本身就是一个标准的PHP脚本可以直接被PHP解释器执行php myapp.phar也可以通过phar://流包装器在代码中像访问普通目录一样访问其内部文件。对于开发者而言这意味着部署和分发变得极其简单——复制一个文件过去就完成了。对于用户而言使用体验也大大提升无需关心复杂的依赖关系。然而PHAR远不止是一个“压缩包”。它有一套完整的文件格式规范支持数字签名验证、文件流式读取、压缩GZ或BZ2等高级特性。理解其内部格式不仅能让你更好地使用它还能在遇到问题时比如签名错误、文件损坏快速定位。更重要的是你可以通过PHP代码动态地创建和修改PHAR文件这为构建自动化构建工具、插件系统甚至实现一些特定的代码分发模式打开了新的大门。今天我们就来彻底拆解PHAR从文件格式到类方法调用手把手教你生成自己的PHAR文件。2. PHAR文件格式深度解析不只是个ZIP包很多人第一次接触PHAR会以为它就是个改了个扩展名的ZIP或TAR文件。这个理解对了一半PHAR的默认格式Phar::PHAR确实基于ZIP和TAR的思想但它有自己严格定义的内部结构并且PHP内核提供了原生支持。一个标准的PHAR文件主要由三部分组成存根Stub、清单Manifest以及文件内容File Contents。2.1 核心结构存根、清单与文件内容存根Stub是PHAR文件的入口点也是这个文件能被直接执行的关键。当你运行php myapp.phar时PHP解释器首先读取并执行的就是存根代码。一个典型的存根看起来像这样#!/usr/bin/env php ?php // 这行是Shebang在Unix-like系统上让shell知道用php解释器执行 Phar::mapPhar(myapp.phar); // 映射phar文件到phar://流 include phar://myapp.phar/path/to/bootstrap.php; // 包含实际的启动文件 __HALT_COMPILER(); // 必须的结束标记此行之后的所有内容PHP解释器将不再解析视为数据部分 ?__HALT_COMPILER();这行代码至关重要。它告诉PHP编译器“到此为止后面的内容不是PHP代码了”。PHAR利用了这个特性将存根之后的所有二进制数据即清单和文件内容当作“数据”来处理从而避免了语法错误。清单Manifest紧跟在存根之后以序列化的形式存储了PHAR内所有文件的元数据。这是一个结构化的数组包含了每个文件的路径、文件大小、压缩类型、CRC32校验和、时间戳、权限以及可选的数字签名信息。当通过phar://流访问文件时PHP运行时实际上是通过查询这个清单来定位和读取内部文件的。清单的格式是二进制的但我们可以通过Phar类的方法如getMetadata()getSignature()来以友好方式读取。文件内容File Contents就是你的项目文件PHP脚本、配置文件、图片等的原始内容它们按照清单中定义的顺序依次排列。如果启用了压缩这里存储的就是压缩后的数据。2.2 三种格式对比PHAR, TAR, ZIPPhar类支持三种格式通过Phar::convertToExecutable()方法可以相互转换也可以通过Phar构造函数的第二个参数指定。格式类型对应常量特点适用场景PHARPhar::PHARPHP原生格式支持所有特性如存根、流包装器。读写性能最好是创建时的默认格式。纯PHP项目需要直接执行或通过phar://访问。TARPhar::TAR基于Unix TAR格式。可以被标准的tar命令解压。不支持内置压缩但可以通过Phar::compress()进行Gzip/Bzip2压缩。需要与非PHP系统如简单的文件备份、资源包交互或希望用户能用通用工具解压查看。ZIPPhar::ZIP基于ZIP格式。可以被任何解压软件打开。PHP的ZipArchive类也能读取。但注意ZIP格式的PHAR文件不能直接通过php命令执行因为它没有PHP可识别的存根。分发包含PHP和非PHP资源的混合包且不要求直接执行仅作为归档使用。重要提示如果你打包的目的是创建一个命令行工具cli应用务必使用PHAR格式。TAR和ZIP格式主要用于归档失去了直接执行的能力。一个常见的误区就是把项目打包成ZIP格式然后试图去执行它结果只会得到语法错误。2.3 数字签名与安全考量PHAR支持使用OpenSSL私钥SHA-256/SHA-512或简单的SHA-1哈希进行签名。签名信息保存在清单中。// 使用SHA-256和OpenSSL私钥签名 $privateKey openssl_pkey_get_private(file://path/to/private.pem); $phar-setSignatureAlgorithm(Phar::OPENSSL, $privateKey); // 使用SHA-1哈希签名较弱不推荐用于安全敏感场景 $phar-setSignatureAlgorithm(Phar::SHA1);签名的作用是验证PHAR文件在创建后是否被篡改。当php.ini中的phar.require_hash设置为1时PHP将拒绝加载任何没有签名的PHAR文件。这是一个重要的安全特性可以防止中间人攻击替换你的PHAR文件。然而在实际操作中我遇到过一个坑签名与文件修改的冲突。一旦一个PHAR文件被签名任何试图修改其内容的操作如$phar[‘newfile.php’] ‘?php …’;都会导致签名失效后续加载时会抛出PharException: signature is broken异常。因此最佳实践是在完成所有文件添加和修改操作后最后一步再进行签名。如果后续需要更新应该重新构建整个PHAR而不是在已签名的文件上打补丁。3. 核心API实战使用Phar类生成你的第一个PHAR文件理论讲得再多不如动手一试。我们从一个最简单的例子开始将一个包含index.php和config.ini的项目目录打包成可执行的myapp.phar。3.1 环境准备与前置检查在开始之前请确保你的环境符合要求PHP版本PHAR扩展从PHP 5.3.0开始默认启用。但为了使用所有现代特性如OpenSSL签名建议使用PHP 7.4或8.x。你可以通过php -m | grep phar来检查扩展是否已加载。php.ini配置检查php.ini中关于phar的配置。; 是否允许读取phar文件默认为On一般不用动 phar.readonly Off这是最关键的一步phar.readonly默认是On这意味着你只能“读”PHAR文件不能“写”或“创建”。在生成PHAR的脚本中你需要将其设置为Off。请注意这个设置可以在运行时用ini_set(‘phar.readonly’, 0);来覆盖但在某些严格的SAPI如某些PHP-FPM配置或安全模式下可能无效。最可靠的方法是在命令行执行构建脚本时通过-d参数临时指定php -d phar.readonly0 build.php。项目结构假设我们有如下目录结构my_project/ ├── src/ │ ├── bootstrap.php │ └── Main.php ├── config/ │ └── settings.ini └── build/ (空目录用于存放生成的phar)3.2 分步构建从目录到可执行文件我们将编写一个build.php脚本放在项目根目录。步骤1创建Phar对象并设置存根?php // build.php $pharFile __DIR__ . /build/myapp.phar; // 如果目标文件已存在先删除Phar对象无法覆盖已存在的文件 if (file_exists($pharFile)) { unlink($pharFile); } try { // 创建Phar对象第二个参数指定为Phar::PHAR $phar new Phar($pharFile, 0, myapp.phar); // 设置存根Stub $stub STUB #!/usr/bin/env php ?php Phar::mapPhar(myapp.phar); require phar://myapp.phar/src/bootstrap.php; __HALT_COMPILER(); ? STUB; $phar-setStub($stub); } catch (Exception $e) { die(创建Phar失败: . $e-getMessage()); }这里有几个细节new Phar($pharFile, 0, ‘myapp.phar’)第三个参数‘myapp.phar’是PHAR文件的别名alias。这个别名在存根中的Phar::mapPhar()和后续通过phar://流访问时都会用到。建议保持别名与文件名一致避免混淆。存根中的require路径‘phar://myapp.phar/src/bootstrap.php’。这里的myapp.phar就是上面设置的别名它构成了访问内部文件的URL。src/bootstrap.php是PHAR内部的实际路径。步骤2添加项目文件创建好对象后我们需要把项目文件添加进去。Phar类提供了多种方法addFile($file, $localname)添加磁盘上的一个文件。$localname是它在PHAR内部的路径。addFromString($localname, $contents)直接从字符串内容创建一个文件。buildFromDirectory($dir, $regex)添加整个目录可以用正则过滤文件。buildFromIterator($iterator, $baseDirectory)使用迭代器添加更灵活。对于我们的简单项目使用buildFromDirectory最方便// 接上面的try块 // 添加src目录下的所有.php文件 $phar-buildFromDirectory(__DIR__ . /src, /\.php$/); // 添加config目录下的所有.ini文件 $phar-buildFromDirectory(__DIR__ . /config, /\.ini$/); // 你也可以选择添加整个目录不进行过滤 // $phar-buildFromDirectory(__DIR__);注意buildFromDirectory默认不会包含空目录。如果你需要保留目录结构比如为了自动加载确保目录下有文件。步骤3可选添加文件元数据你可以为PHAR文件整体或内部单个文件附加元数据metadata用于存储版本号、作者、构建时间等信息。// 设置整个PHAR的元数据 $phar-setMetadata([ version 1.0.0, built_at time(), author Your Name ]); // 为内部某个文件设置元数据需要在addFile之后且该文件已存在 // 通常更灵活的做法是在构建过程中用addFromString并附带元数据步骤4可选压缩与签名为了减少文件体积和增加安全性我们可以进行压缩和签名。// 使用Gzip压缩整个PHAR文件 // 注意这会生成一个 .phar.gz 文件原 .phar 文件会被替换 $phar-compress(Phar::GZ); // 重新获取压缩后的Phar对象因为文件路径变了 $phar new Phar($pharFile . .gz); // 使用OpenSSL进行SHA-256签名需要私钥 $privateKey openssl_pkey_get_private(file_get_contents(private.pem), your_passphrase); if ($privateKey) { $phar-setSignatureAlgorithm(Phar::OPENSSL, $privateKey); openssl_free_key($privateKey); } else { echo “警告私钥加载失败跳过签名。\n”; }压缩的注意事项压缩后文件扩展名会改变.phar.gz执行时也需要用对应的文件名。另外压缩是全局性的要么全部压缩要么不压缩。PHAR不支持对内部单个文件选择不同压缩算法。步骤5测试运行构建完成后在终端测试# 给phar文件添加可执行权限Unix-like系统 chmod x build/myapp.phar # 方式1直接执行依赖存根中的Shebang ./build/myapp.phar # 方式2通过php解释器执行 php build/myapp.phar如果一切顺利你的应用就应该跑起来了。你可以通过phar://流在代码中访问内部资源// 在bootstrap.php或其他内部脚本中 $config parse_ini_file(phar://myapp.phar/config/settings.ini);4. 高级应用与自动化构建掌握了基础构建后我们可以探索更复杂的场景比如处理Composer依赖、创建插件系统以及将其集成到CI/CD流程中。4.1 整合Composer依赖现代PHP项目几乎都离不开Composer。将依赖打包进PHAR是常见需求。你不能简单地把vendor目录打包进去因为Composer的自动加载器vendor/autoload.php依赖于真实的文件系统路径。正确做法是在构建脚本中引导Composer确保构建环境已经通过composer install --no-dev --optimize-autoloader安装了生产依赖。--optimize-autoloader会生成类映射文件能提升在PHAR中自动加载的性能。将整个vendor目录除了vendor/composer/installed.json等可能产生路径问题的文件打包进去。在存根或启动脚本中修改Composer自动加载器的路径。因为vendor/autoload.php里包含的路径是构建时的绝对路径在PHAR中会失效。我们需要一个“PHAR感知”的自动加载器。一个实用的技巧是在项目的bootstrap.php中做如下处理// bootstrap.php if (extension_loaded(phar) ($pharPath Phar::running())) { // 当前运行在phar中 $vendorPath phar:// . $pharPath . /vendor/autoload.php; } else { // 正常开发环境 $vendorPath __DIR__ . /../vendor/autoload.php; } if (file_exists($vendorPath)) { require $vendorPath; } else { die(无法找到Composer自动加载器。请先运行 composer install。); }这样无论是开发环境还是PHAR环境都能正确加载依赖。4.2 动态PHAR与插件架构由于Phar类允许我们以编程方式添加、修改文件我们可以利用它来实现动态的插件系统。例如一个主应用打包成core.phar它可以从指定目录加载额外的plugin-*.phar文件。核心思路是使用Phar::mount($pharPath, $externalPath)方法。这个方法可以将一个外部路径或另一个PHAR文件内部路径“挂载”到当前运行的PHAR的虚拟文件系统中。// 在主应用core.phar的启动代码中 foreach (glob(/path/to/plugins/*.phar) as $pluginPhar) { $pluginName basename($pluginPhar, .phar); // 将插件phar文件挂载到虚拟目录 phar://core.phar/plugins/$pluginName/ # 1. 两数之和 ## 题目 给定一个整数数组 nums 和一个整数目标值 target请你在该数组中找出 和为目标值 target 的那 两个 整数并返回它们的数组下标。 你可以假设每种输入只会对应一个答案。但是数组中同一个元素在答案里不能重复出现。 你可以按任意顺序返回答案。 ## 思路 * 使用哈希表 将数组中的元素作为key 下标作为value * 遍历数组 计算target - nums[i] 如果哈希表中存在这个值 那么返回两个下标 * 如果不存在 将当前元素和下标存入哈希表 ## 代码 cpp class Solution { public: vectorint twoSum(vectorint nums, int target) { unordered_mapint,int map; for(int i 0; i nums.size(); i) { auto iter map.find(target - nums[i]); if(iter ! map.end()) { return {iter-second,i}; } map.insert(pairint,int(nums[i],i)); } return {}; } };
