在Linux (CentOS) 中编译安装PHP PDO_MySQL扩展的方法

季宁
季宁
发布时间:2026-10-13| 6人浏览过
原创

本文详细记录了在 Linux(以 CentOS 为例)系统中,通过源码编译方式手动安装 PHP PDO_MySQL 扩展的完整流程。涵盖从配置编译环境、生成 .so 动态库文件到最终修改 php.ini 启用扩展的所有关键步骤。

进入 PDO 扩展目录并初始化编译环境

编译扩展前,需要确保服务器已安装 gcc、make 等基础编译工具以及 PHP 开发包(如 php-devel)。以下步骤假设读者已通过源码下载了与当前 PHP 版本一致的 PHP 安装包。

第1步:导航至 pdo_mysql 源码目录

进入 PHP 源码包的 ext/pdo_mysql 子目录。请注意,此处指的是源代码解压后的位置,而非 PHP 的安装目录。

# 示例路径,请根据实际存储位置修改
[root@localhost ~]# cd /tmp/lamp/php-5.3.19/ext/pdo_mysql/

第2步:运行 phpize 生成 configure 脚本

使用 phpize 命令为扩展准备编译环境。该命令会根据当前系统的 PHP 配置生成必要的配置文件(如 configure)。

[root@localhost pdo_mysql]# /usr/local/php/bin/phpize

注意:上述命令中的路径需指向服务器上实际安装的 PHP 二进制文件路径。如果系统环境变量已配置好 phpize,可直接输入 phpize。

第3步:执行配置参数指定依赖路径

生成 configure 文件后,运行配置命令。此步骤至关重要,用于告知编译器去哪里寻找 PHP 的头文件和 MySQL 客户端库。

[root@localhost pdo_mysql]# ./configure --with-php-config=/usr/local/php/bin/php-config --with-pdo-mysql=/usr/local/mysql/

# 参数解释:
# --with-php-config  : 指定 php-config 的路径,用于获取 PHP 配置信息
# --with-pdo-mysql   : 指定 MySQL 数据库的安装根目录或客户端路径

风险提醒:若未正确指定路径或系统缺少 MySQL 客户端开发库(如 mysql-devel),配置步骤可能会报错。

第4步:编译并安装模块

配置完成后,依次执行编译和安装命令:

[root@localhost pdo_mysql]# make && make install

编译成功后,终端通常会输出生成的 .so 文件路径。如下图所示,关注命令行输出中提示的 extension 目录:

该目录下即为生成的 pdo_mysql.so 文件位置。

修改 php.ini 配置文件

第5步:加载动态库

打开服务器的 php.ini 配置文件。在 [Dynamic Extensions] 部分(通常在文件末尾附近)添加一行代码,指向刚才生成的 pdo_mysql.so 绝对路径。

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

提示:具体路径中的版本号文件夹可能因 PHP 版本不同而有所差异,请根据上一步的输出结果进行准确匹配。配置保存后的效果示意如下:

重启服务并验证扩展

第6步:重启 Web 服务

使配置生效必须重启 Apache(httpd)或 Nginx 对应的 PHP-FPM 进程。

[root@localhost ~]# systemctl restart httpd
# 或者如果是 Nginx + PHP-FPM:
[root@localhost ~]# systemctl restart php-fpm

第7步:检查 phpinfo 确认安装成功

创建一个包含 的 PHP 文件并通过浏览器访问。在输出的页面中搜索 “PDO” 关键词。如果出现 pdo_mysql 的详细配置项(Driver, Revision 等),即表示安装成功。

简要总结

以上就是在 Linux (CentOS) 环境下通过源码手动编译安装 PHP PDO_MySQL 扩展的详细内容。该方法适用于大多数 RHEL/CentOS 系列系统。更多关于 PHP 数据库连接相关的技巧,欢迎持续关注本站后续文章!

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。