萬盛學電腦網

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

Linux 原始碼編譯安裝 PHP 完整配置參數詳細中文說明

前言

源碼編譯 PHP 可精確控制功能模組、優化效能、滿足特定版本需求。本文整理常用 ./configure 參數並附中文說明,供參考選擇。實際編譯請根據專案需求裁剪。

核心配置參數分類表

1. 安裝路徑與基礎設定

參數說明範例
--prefixPHP 安裝根目錄--prefix=/usr/local/php
--with-config-file-pathphp.ini 存放目錄--with-config-file-path=/usr/local/php/etc
--with-config-file-scan-dir掃描額外 .ini 檔案目錄--with-config-file-scan-dir=/usr/local/php/etc/php.d

2. Web 伺服器整合(二選一)

模式參數說明
Apache 模組--with-apxs2指定 apxs 路徑,編譯為 Apache DSO 模組
PHP-FPM (Nginx)--enable-fpm啟用 FastCGI Process Manager(生產環境標準)
--with-fpm-userFPM 運行使用者(預設 www-data)
--with-fpm-groupFPM 運行群組

3. 資料庫擴充

參數說明
--with-mysqliMySQL 改良版擴充,指定 mysql_config 路徑
--with-pdo-mysqlPDO MySQL 驅動(現代應用推薦)
--with-pgsqlPostgreSQL 原生驅動
--with-pdo-pgsqlPDO PostgreSQL 驅動
--with-sqlite3SQLite 3 支援
--with-pdo-sqlitePDO SQLite 驅動

注意:PHP 7+ 移除 --with-mysql(舊 mysql_* 函數),請改用 mysqli/PDO。

4. 圖形處理與字型

參數說明
--with-gdGD 圖形庫(PHP 7.4+ 內建,無需外部)
--with-freetype-dirFreeType 字型庫路徑(支援 TTF)
--with-jpeg-dirJPEG 庫路徑
--with-png-dirPNG 庫路徑
--with-webp-dirWebP 圖片支援
--with-xpm-dirXPM 圖片支援
--enable-gd-native-ttf使用 FreeType 渲染 TrueType 字型(PHP 7.2+ 預設啟用)

5. 資料壓縮與序列化

參數說明
--with-zlibzlib 壓縮(HTTP 壓縮、gzencode 等)
--with-bz2bzip2 壓縮支援
--enable-zipZip 壓縮檔處理(PHP 8.0+ 移至 zip 擴充)
--enable-pharPHAR 封裝支援(預設啟用)

6. XML 與 Web 服務

參數說明
--with-libxml-dirlibxml2 路徑(核心 XML 支援)
--enable-xmlXML 支援(預設啟用)
--enable-simplexmlSimpleXML 擴充
--enable-xmlreaderXMLReader 拉式解析
--enable-xmlwriterXMLWriter 寫入
--with-xslXSLT 轉換(需 libxslt)
--enable-soapSOAP Web Service 客戶端/伺服端
--with-xmlrpcXML-RPC 支援

7. 國際化與編碼

參數說明
--enable-mbstring多位元組字串處理(中文/日文/韓文必備)
--enable-intlICU 國際化擴充(格式化、排序、轉換)
--with-gettextGNU gettext 多語系支援
--with-iconv字元集轉換(通常內建)
--with-recodeGNU Recode 字元集轉換(較少用)

8. 加密與安全

參數說明
--with-opensslOpenSSL 加密/SSL/TLS(必備)
--with-mhashMhash 雜湊庫(PHP 7.1+ 已棄用,改用 hash 擴充)
--with-mcryptMcrypt 加密庫(PHP 7.2+ 移除,改用 Sodium/OpenSSL)
--with-sodiumlibsodium 現代加密庫(PHP 7.2+ 內建)
--with-gmpGMP 大整數運算

9. 效能與除錯

參數說明
--enable-opcacheZend OPcache 位元碼快取(生產必開)
--disable-debug關閉除錯模式(生產環境)
--disable-rpath不嵌入運行時庫搜尋路徑
--enable-inline-optimization啟用內聯優化(GCC)

10. 其他常用

參數說明
--enable-socketsSocket 網路程式支援
--enable-pcntl進程控制(多進程、信號處理)
--enable-shmop共享記憶體操作
--enable-sysvmsgSystem V 訊息佇列
--enable-sysvsemSystem V 信號量
--enable-sysvshmSystem V 共享記憶體
--enable-calendar日曆/日期計算擴充
--enable-bcmath任意精度數學(財務計算、Zabbix 需求)
--enable-exifEXIF 圖片元數據讀取
--with-curlcURL HTTP 客戶端庫
--with-pear安裝 PEAR 套件管理器
--with-ldapLDAP 目錄服務支援
--with-imap / --with-imap-sslIMAP 郵件協議
--with-kerberosKerberos 認證支援

實際編譯範例(PHP 8.2 + Nginx + MySQL 典型生產配置)

./configure \
    --prefix=/usr/local/php \
    --with-config-file-path=/usr/local/php/etc \
    --with-config-file-scan-dir=/usr/local/php/etc/php.d \
    --enable-fpm \
    --with-fpm-user=www \
    --with-fpm-group=www \
    --enable-mbstring \
    --enable-intl \
    --with-openssl \
    --with-zlib \
    --with-bz2 \
    --with-curl \
    --enable-gd \
    --with-freetype \
    --with-jpeg \
    --with-webp \
    --enable-bcmath \
    --enable-sockets \
    --enable-pcntl \
    --enable-shmop \
    --enable-soap \
    --enable-opcache \
    --with-mysqli=mysqlnd \
    --with-pdo-mysql=mysqlnd \
    --with-pdo-sqlite \
    --with-zip \
    --disable-debug \
    --disable-rpath \
    --enable-inline-optimization

編譯安裝流程

make -j$(nproc)      # 多核心並行編譯
make test            # 運行測試套件(可選但推薦)
sudo make install    # 安裝

# 複製生產環境 php.ini
cp php.ini-production /usr/local/php/etc/php.ini

# 配置 php-fpm
cp /usr/local/php/etc/php-fpm.conf.default /usr/local/php/etc/php-fpm.conf
cp /usr/local/php/etc/php-fpm.d/www.conf.default /usr/local/php/etc/php-fpm.d/www.conf
# 編輯 www.conf 設定 listen = 127.0.0.1:9000 或 unix socket

版本遷移提醒

  • PHP 5.6 → 7.0:移除 mysql_*、ereg、mcrypt 等舊擴充;引入標量型別宣告、返回型別宣告、匿名類別。
  • PHP 7.4 → 8.0:移除 --with-gd 外部依賴(內建 GD)、--enable-zip 移至獨立擴充、JIT 編譯器引入。
  • PHP 8.1+:--with-freetype-dir 等目錄參數改為 --with-freetype(pkg-config 自動偵測)。

編譯前請務必查閱對應版本 ./configure --help 確認參數有效性。

copyright © 萬盛學電腦網 all rights reserved