# Debian/Ubuntu
apt-get update && apt-get install -y php-curl
# 或指定版本
apt-get install -y php8.2-curl
# RHEL/CentOS/Rocky/AlmaLinux (需 EPEL + Remi)
dnf install -y epel-release
dnf install -y https://rpms.remirepo.net/enterprise/remi-release-9.rpm
dnf module enable php:remi-8.2
dnf install -y php-curl
# Alpine
apk add php82-curl
# 驗證
php -m | grep curl
php -r 'var_dump(curl_version());'
適用場景:PHP 為源碼編譯安裝、需特定版本 CURL、嵌入式環境、無包管理器權限。
# 安裝 libcurl 開發包
apt-get install -y libcurl4-openssl-dev pkg-config # Debian
yum install -y libcurl-devel openssl-devel # RHEL
# 確認 PHP 安裝路徑與 phpize 位置
which php # /usr/local/php/bin/php
which phpize # /usr/local/php/bin/phpize
php -v # 確認版本 (如 8.2.10)
# 從 php.net 下載與運行版本完全一致的源碼包
wget https://www.php.net/distributions/php-8.2.10.tar.gz
tar -xzf php-8.2.10.tar.gz
cd php-8.2.10/ext/curl
# 1. phpize 生成 configure
/usr/local/php/bin/phpize
# 輸出應包含:
# Configuring for:
# PHP Api Version: 20220829
# Zend Module Api No: 20220829
# Zend Extension Api No: 420220829
# 2. 配置 --with-curl 指向 libcurl 安裝路徑 (通常 /usr)
./configure --with-php-config=/usr/local/php/bin/php-config --with-curl=/usr
# 3. 編譯
make -j$(nproc)
# 4. 安裝 (複製 curl.so 到 extension_dir)
make install
# 輸出類似:Installing shared extensions: /usr/local/php/lib/php/extensions/no-debug-non-zts-20220829/
# 1. 確認 extension_dir
php -i | grep extension_dir
# /usr/local/php/lib/php/extensions/no-debug-non-zts-20220829
# 2. 修改 php.ini
echo "extension=curl.so" >> /usr/local/php/etc/php.ini
# 或建議單獨文件
echo "extension=curl.so" > /usr/local/php/etc/conf.d/20-curl.ini
# 3. 重載 PHP-FPM / Apache
systemctl reload php-fpm
# 或
systemctl reload httpd
php -m | grep -i curl
# curl
php -r 'print_r(curl_version());'
# Array
# (
# [version_number] => 478208
# [age] => 3
# [features] => 7007
# [ssl_version_number] => 0
# [version] => 7.88.1
# [host] => x86_64-pc-linux-gnu
# [ssl_version] => OpenSSL/3.0.11
# [libz_version] => 1.2.13
# [protocols] => dict, file, ftp, ftps, gopher, gophers, http, https, imap, imaps, ldap, ldaps, mqtt, pop3, pop3s, rtsp, scp, sftp, smb, smbs, smtp, smtps, telnet, tftp, ws, wss
# )
| 錯誤 | 原因 | 解決 |
|---|---|---|
| configure: error: Please reinstall the libcurl distribution | 缺少 libcurl-dev 或路徑錯誤 | 安裝 libcurl4-openssl-dev,指定 --with-curl=/usr |
| phpize: command not found | 未安裝 php-dev / php-devel | apt install php-dev / dnf install php-devel |
| undefined symbol: curl_easy_init | 運行時找不到 libcurl.so / 版本不匹配 | ldconfig、檢查 LD_LIBRARY_PATH、確保 libcurl 版本一致 |
| Module already loaded | php.ini 重複載入 / 同時在 cli/fpm 載入 | 檢查所有 ini 文件,去重 |
| Version mismatch: Module compiled with API 20220829, PHP expects 20210902 | phpize 版本與運行時 PHP 版本不一致 | 使用正確版本的 phpize (與目標 php 同前綴) |
FROM php:8.2-fpm-alpine AS builder
RUN apk add --no-cache libcurl curl-dev $PHPIZE_DEPS \
&& docker-php-ext-install -j$(nproc) curl
FROM php:8.2-fpm-alpine
COPY --from=builder /usr/local/lib/php/extensions/no-debug-non-zts-20220829/curl.so /usr/local/lib/php/extensions/
RUN echo "extension=curl.so" > /usr/local/etc/php/conf.d/docker-php-ext-curl.ini
生產環境首選包管理器 (apt/dnf/apk),版本一致性有保障、安全更新自動化、依賴解決完善。
源碼編譯 僅用於特殊版本需求、非標準路徑 PHP、容器構建優化。核心要點:**phpize 版本必須與目標 PHP 完全一致**、**libcurl-dev 必須預裝**、**extension_dir 路徑精確配置**。