萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP gzuncompress() 無法使用?缺少 zlib 擴充編譯安裝完整步驟

gzuncompress() 屬於 **zlib 擴充** 函數,非 PHP 核心內建,若環境編譯時未加入 `--with-zlib`,呼叫會報 Call to undefined function gzuncompress()。本文提供 CentOS 6.5 + PHP 5.3 環境下的動態編譯安裝步驟。

快速診斷

php -m | grep zlib        # 若無輸出,擴充未載入
php -i | grep zlib        # 檢查 configure 參數是否含 --with-zlib
# 或建立 phpinfo.php 檢視 zlib 區塊

動態編譯安裝 zlib 擴充 (PHP 擴充源碼目錄法)

# 1. 進入 PHP 源碼擴充目錄 (需與執行中 PHP 版本完全一致)
cd /root/dl/php/ext/zlib   # 例:PHP 5.3.28 源碼包解壓路徑

# 2. 重命名配置檔 (舊版慣例)
mv config0.m4 config.m4

# 3. phpize 產生建置腳本
/usr/local/php/bin/phpize
# 輸出應顯示:Configuring for: PHP Api Version: 20090626, Zend Module Api No: 20090626...

# 4. 配置 (指定 php-config 路徑)
./configure --with-php-config=/usr/local/php/bin/php-config
# 若系統 zlib 庫非標準路徑,加上 --with-zlib-dir=/usr/local/zlib

# 5. 編譯安裝
make && make install
# 輸出提示:Installing shared extensions: /usr/local/php/lib/php/extensions/no-debug-non-zts-20090626/

# 6. 複製 .so 到 extension_dir (若 make install 未自動複製)
cp modules/zlib.so /usr/local/php/lib/php/extensions/no-debug-non-zts-20090626/

# 7. 修改 php.ini 載入
echo "extension=zlib.so" >> /usr/local/php/lib/php.ini

# 8. 重啟 PHP-FPM / Apache
systemctl restart php-fpm  # 或 service httpd restart

驗證安裝

php -r "var_dump(function_exists('gzuncompress'));" # bool(true)
php -r "echo gzuncompress(gzcompress('test'));";    # test

現代環境 (PHP 7.0+ / Ubuntu / Docker) 簡易安裝

# Ubuntu/Debian
apt-get update && apt-get install -y php-zlib libz-dev
# 或針對特定版本
apt-get install -y php7.4-zlib

# Dockerfile
RUN docker-php-ext-install zlib

常見坑點

  • 版本不匹配:`phpize` 必須屬於**目標 PHP 版本** (多版本共存時易用錯),確認 /usr/local/php/bin/phpize。
  • 缺少系統庫:需安裝 `zlib-devel` (CentOS) / `libz-dev` (Ubuntu) 提供頭文件與靜態庫。
  • Thread Safety (ZTS) 不符:PHP 編譯為 ZTS 時,擴充也需 `--enable-maintainer-zts` 重新編譯,否則載入會段錯誤。
  • php.ini 生效位置:php --ini 確認載入的 ini 檔案,避免改錯檔案。

替代方案

  • 純 PHP 實現:gzdecode() (PHP 5.4+ 內建、無需 zlib 擴充)、gzinflate() (需 zlib)。
  • Composer 套件:ralouphie/php-zlib (純 PHP 實現 zlib 解壓)。

完成擴充編譯與載入,即可正常使用 `gzcompress`/`gzuncompress`/`gzencode`/`gzdecode` 等壓縮函數,滿足資料傳輸、快取壓縮、HTTP 內容編碼等需求。

copyright © 萬盛學電腦網 all rights reserved