如何在 PHP 中通过Composer安装 PHP-Rar 库读取并提取 RAR 格式压缩包-composer-PHP中文网

php-rar是需编译安装的原生扩展，非composer包，故composer require会失败；正确方式是系统级安装（如apt install php-rar或pecl install rar）并启用rar.so，再通过rararchive类操作rar文件。

如何在 php 中通过composer安装 php-rar 库读取并提取 rar 格式压缩包

PHP-Rar 扩展不是 Composer 包，不能用 `composer require` 安装

PHP-Rar 是一个 PHP 扩展（extension），不是纯 PHP 的 Composer 包。它底层依赖 librar，必须编译进 PHP 解释器，因此 composer require 会失败，报错类似 Package php-rar/php-rar not found 或 Could not find package php-rar/php-rar。你看到的某些 GitHub 上标着 “php-rar” 的 Composer 包，基本是封装了系统命令（如 unrar）的 wrapper，功能和稳定性远不如原生扩展。

正确安装方式：编译或启用 PHP-Rar 扩展

前提是你的 PHP 环境允许加载扩展（非 shared hosting，有 root 或管理员权限）。步骤取决于系统：

Linux（Ubuntu/Debian）：sudo apt install php-rar（如果源里有对应 PHP 版本的包），然后确认 rar.so 已写入 php.ini 并重启 PHP-FPM 或 Apache
Linux（CentOS/RHEL）：需手动编译，先装 librar-devel 和 php-devel，再从 PECL 下载源码，phpize && ./configure && make && sudo make install，最后在 php.ini 加 extension=rar
macOS（Homebrew）：用 pecl install rar，确保已装 php-dev 和 librar
Windows：下载对应 PHP 版本和线程安全（TS/NTS）的 php_rar.dll，放进 ext/ 目录，php.ini 中加 extension=php_rar.dll

装完后运行 php -m | grep rar 或 phpinfo() 查看是否启用成功。

读取 RAR 文件的典型代码与常见坑

扩展启用后，用 RarArchive::open() 打开，再用 getEntries() 遍历，extract() 提取。注意以下几点：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

RarArchive::open() 返回 false 时，不代表文件不存在，可能是密码保护、损坏或不支持的 RAR5 格式（PHP-Rar 仅支持 RAR3，不支持 RAR5）
提取单个文件要用 $entry->extract(false, $targetPath)；第二个参数设为 false 表示不解压到当前目录，而是按 $targetPath 路径写入
若 RAR 有密码，必须调用 $archive->setPassword('xxx') 在 open() 之后、getEntries() 之前
中文文件名可能乱码，因 RAR 存储编码不统一，PHP-Rar 默认按 CP850 或 ISO-8859-1 解析，可尝试用 mb_convert_encoding($entry->getName(), 'UTF-8', 'CP850') 转换

简单示例：

$archive = RarArchive::open('sample.rar');
if ($archive === false) {
    die("无法打开 RAR 文件");
}
$entries = $archive->getEntries();
foreach ($entries as $e) {
    $e->extract(false, './output/' . $e->getName());
}
$archive->close();