Linux 安裝 PHP Zip 擴充套件完整步驟

編譯安裝 (PECL)

# 1. 下載原始碼 (或直接 pecl install zip)
wget https://pecl.php.net/get/zip-1.21.1.tgz
tar zxvf zip-1.21.1.tgz
cd zip-1.21.1

# 2. phpize (需安裝 php-dev)
/usr/local/php/bin/phpize

# 3. 配置、編譯、安裝
./configure --with-php-config=/usr/local/php/bin/php-config
make && make install

啟用擴充套件

編譯成功後會提示 .so 路徑，例如：

/usr/local/php/lib/php/extensions/no-debug-non-zts-20210902/zip.so

編輯 php.ini：

extension_dir = "/usr/local/php/lib/php/extensions/no-debug-non-zts-20210902/"
extension = zip.so

驗證安裝

php -m | grep zip
# 或
php -r "var_dump(class_exists('ZipArchive'));"

常見問題

• phpize: command not found → 安裝 php-dev / php-devel。
• configure: error: Please reinstall the libzip distribution → 安裝 libzip-devel (CentOS) / libzip-dev (Ubuntu)。
• 多 PHP 版本共存 → 指定正確的 phpize 和 php-config 路徑。

快速安裝 (包管理器)

# Ubuntu/Debian
sudo apt-get install php-zip
sudo systemctl restart php8.1-fpm

# CentOS/RHEL (EPEL)
sudo yum install php-pecl-zip
sudo systemctl restart php-fpm

推薦使用包管理器，自動處理相依性與更新。