使用APT包管理器安裝(推薦)
APT是Debian系統默認的包管理工具,適用于安裝官方倉庫中提供的PHP擴展,操作簡單且能自動處理依賴關系。
sudo apt update
,確保系統獲取最新的軟件包信息。sudo apt install php-mysql
,安裝cURL擴展用sudo apt install php-curl
,安裝GD擴展用sudo apt install php-gd
(常見擴展還包括php-xml
、php-mbstring
、php-zip
等)。sudo systemctl restart apache2
;若使用Nginx配合PHP-FPM,需重啟PHP-FPM(如sudo systemctl restart php8.2-fpm
)和Nginx(sudo systemctl restart nginx
),使擴展生效。從源碼編譯安裝(適用于APT無的擴展)
若需要安裝官方倉庫中沒有的擴展或特定版本,可通過源碼編譯安裝。
extension.tar.gz
),運行tar -zxvf extension.tar.gz
解壓,進入解壓后的目錄。README
或INSTALL
文件,安裝必要的依賴包(如php-dev
、gcc
、make
等,可通過sudo apt install php-dev build-essential
安裝基礎依賴)。phpize
(生成編譯配置)、./configure
(檢查環境)、make
(編譯)、sudo make install
(安裝,擴展文件通常位于/usr/lib/php/
目錄下)。php.ini
文件(路徑可通過php --ini
查看),添加extension=extension.so
(如extension=mysqli.so
),保存后重啟Web服務器。使用PECL安裝(便捷方式)
PECL是PHP擴展社區庫,提供預編譯的擴展包,安裝流程簡化。
sudo apt install php-pear php-dev
,安裝PECL及編譯工具。sudo pecl install extension_name
命令安裝(如sudo pecl install redis
、sudo pecl install mongodb
),PECL會自動處理依賴和編譯。php.ini
文件,添加extension=extension.so
(如extension=redis.so
),重啟Web服務器。使用Docker安裝(容器化環境)
若使用Docker部署PHP應用,可在Dockerfile中直接指定擴展,簡化環境配置。
FROM php:8.2-apache
或FROM php:8.2-fpm
)。RUN
指令安裝擴展,例如安裝常用擴展:RUN apt-get update && apt-get install -y php-mysql php-curl php-gd php-xml php-mbstring php-zip
;或使用docker-php-ext-install
命令安裝(需提前安裝依賴,如RUN docker-php-ext-install pdo_mysql mysqli gd zip
)。docker build -t my-php-app .
構建鏡像,用docker run -d -p 80:80 my-php-app
啟動容器。驗證擴展安裝
無論采用哪種方法,安裝完成后需驗證擴展是否生效:
php -m
,查看輸出列表中是否包含已安裝的擴展名稱(如mysql
、curl
)。/var/www/html
)創建info.php
文件,內容為<?php phpinfo(); ?>
,通過瀏覽器訪問http://your_server_ip/info.php
,在“Loaded Configuration File”部分查找擴展是否加載。注意事項
php -v
查看當前版本。sudo apt install
安裝對應依賴(如libzip-dev
用于Zip擴展)。info.php
文件(如rm /var/www/html/info.php
),避免泄露服務器信息。