萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Linux 下 PHP 安裝 CURL 擴展完整教程 (源碼編譯與包管理雙方案)

方案一:包管理器安裝 (推薦生產環境)

# 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)

適用場景: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 源碼包

# 從 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-develapt install php-dev / dnf install php-devel
undefined symbol: curl_easy_init運行時找不到 libcurl.so / 版本不匹配ldconfig、檢查 LD_LIBRARY_PATH、確保 libcurl 版本一致
Module already loadedphp.ini 重複載入 / 同時在 cli/fpm 載入檢查所有 ini 文件,去重
Version mismatch: Module compiled with API 20220829, PHP expects 20210902phpize 版本與運行時 PHP 版本不一致使用正確版本的 phpize (與目標 php 同前綴)

Dockerfile 示例 (多階段構建)

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 路徑精確配置**。

copyright © 萬盛學電腦網 all rights reserved