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 區塊
# 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
# 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
/usr/local/php/bin/phpize。php --ini 確認載入的 ini 檔案,避免改錯檔案。gzdecode() (PHP 5.4+ 內建、無需 zlib 擴充)、gzinflate() (需 zlib)。ralouphie/php-zlib (純 PHP 實現 zlib 解壓)。完成擴充編譯與載入,即可正常使用 `gzcompress`/`gzuncompress`/`gzencode`/`gzdecode` 等壓縮函數,滿足資料傳輸、快取壓縮、HTTP 內容編碼等需求。