Linux下手动编译安装PHP扩展的方法

准备工作

在执行编译之前，请确保目标Linux服务器已满足以下条件：

• 基础工具链：系统需安装gcc、make等编译工具。
• 开发头文件：通常需要安装对应PHP版本的开发包（如 php-devel 或 php-dev），以便提供编译所需的头文件。
• 扩展依赖：例如编译MySQL相关扩展时，需确保系统中已安装MySQL客户端开发库。
• Web服务器运行状态：准备在完成后重启Apache或Nginx以加载新扩展。

第1步：获取扩展源码

PHP官方提供了PECL仓库作为扩展的标准分发渠道。建议优先访问 http://pecl.php.net/ 查找所需扩展的最新稳定版。

1. 进入临时目录：

cd /usr/local/src/

2. 下载源码包：

wget http://pecl.php.net/get/PDO_MYSQL-1.0.2.tgz

3. 解压并进入源码目录：

tar xzvf PDO_MYSQL-1.0.2.tgz
cd PDO_MYSQL-1.0.2

注意版本号可能会随时间更新，请以实际下载的最新版为准。

第2步：使用 PHPize 准备编译环境

PHP扩展必须通过 phpize 脚本来生成当前环境的 configure 脚本。此工具通常随 PHP 一起安装。

/usr/local/php/bin/phpize

执行成功后，终端会输出类似以下的信息，确认 API 版本匹配：

Configuring for:
PHP Api Version:         20041225
Zend Module Api No:      20060613
Zend Extension Api No:   220060519

第3步：Configure 配置编译参数

运行 configure 脚本，指定 php-config 的路径。这是告诉编译器去哪里寻找 PHP 的安装配置和路径。

./configure --with-php-config=/usr/local/php/bin/php-config

若无报错，则说明配置成功。若出现 "Header not found" 类错误，通常意味着缺少该扩展对应的系统级开发库（如 mysql-devel）。

第4步：编译与安装

按照标准 Linux 软件编译流程进行操作：

make

make install

make install 成功后，终端会输出生成的 .so 文件路径。例如：
/usr/local/php/lib/php/extensions/debug-non-zts-20060613/pdo_mysql.so
请务必记录该路径，后续配置 PHP 时需要用到。

第5步：配置 PHP 加载扩展

找到你的 PHP 配置文件 php.ini（常见位置如 /etc/php.ini 或 /usr/local/lib/php.ini），在末尾添加一行来引入刚生成的动态库：

extension=/usr/local/php/lib/php/extensions/debug-non-zts-20060613/pdo_mysql.so

保存文件后，根据你使用的 Web 服务器重启服务：

• Apache: systemctl restart httpd 或 service apache2 restart
• Nginx + PHP-FPM: systemctl restart php-fpm（或对应版本的fpm服务）

完成判断

验证扩展是否安装成功的最直接方法是查看 PHP 信息页面或使用命令行检查：

php -m | grep pdo_mysql

如果输出中出现了 pdo_mysql，则说明手动编译安装已完成且生效。

常见问题排错

• 找不到 phpize 命令：说明未安装 php-devel 或 php-dev 包。
• configure 失败：通常是缺失底层数据库驱动的头文件，请检查系统包管理器（如 apt/yum）是否安装了如 mysql-client-dev 之类的开发包。
• 加载后提示扩展不匹配：请确认 php.ini 中的 extension 路径与 make install 输出的路径完全一致。

以上就是Linux下手动编译安装PHP扩展的详细内容，更多关于PHP扩展的资料请关注本站其它相关文章！