linux如何安装pdo_mysql
- Linux
- 2025-07-22
- 4
Linux系统中安装PDO_MySQL扩展,主要涉及到PHP环境的搭建、PDO扩展的安装以及MySQL数据库的配置,以下是详细的安装步骤和注意事项:
环境准备
-
检查PHP版本:确保系统已安装PHP,且版本符合要求(建议7.2以上),可以通过命令php -v查看PHP版本。
-
安装MySQL或MariaDB:PDO_MySQL用于连接MySQL数据库,因此需确保MySQL或MariaDB已安装并正在运行,可以使用systemctl status mysqld或systemctl status mariadb检查服务状态。

-
更新软件包索引:在安装扩展前,建议先更新系统的软件包索引,以确保获取到最新版本的软件包,对于基于Debian的系统(如Ubuntu),使用sudo apt-get update;对于基于RPM的系统(如CentOS、RHEL),使用sudo yum update -y。
安装PDO_MySQL扩展
使用包管理器安装
-
Debian/Ubuntu系统:
- 执行命令sudo apt-get install php-pdo-mysql来安装PDO_MySQL扩展。
- 安装完成后,重启Web服务器以使更改生效,对于Apache,使用sudo service apache2 restart;对于Nginx,可能需要重启PHP-FPM服务,使用sudo systemctl restart php-fpm。
-
CentOS/RHEL系统:

- 可能需要启用EPEL和Remi仓库,以获取额外的PHP扩展包,执行sudo yum install -y epel-release和sudo yum install -y http://rpms.remirepo.net/enterprise/remi-release-7.rpm(针对CentOS7/RHEL7)。
- 选择与PHP版本对应的仓库,对于PHP 7.4,执行sudo yum-config-manager --enable remi-php74。
- 执行命令sudo yum install -y php-pdo php-mysqlnd来安装PDO核心库和MySQL驱动,注意,php-mysqlnd包包含了PDO_MySQL的实现。
- 安装完成后,同样需要重启Web服务器或PHP-FPM服务以使更改生效。
-
安装PECL工具:PECL是PHP扩展社区库,提供了大量的PHP扩展,需要安装PECL工具,对于Debian/Ubuntu系统,执行sudo apt-get install php-pear;对于CentOS/RHEL系统,执行sudo yum install php-pear。
-
安装PDO_MySQL扩展:执行命令pecl install pdo_mysql来安装PDO_MySQL扩展。
-
配置PHP:安装完成后,需要在PHP的配置文件php.ini中添加extension=pdo_mysql.so来启用扩展,对于Debian/Ubuntu系统,编辑/etc/php//cli/php.ini文件;对于CentOS/RHEL系统,编辑/etc/php.ini文件。

-
重启Web服务器:保存php.ini文件后,重启Web服务器以使更改生效。
-
使用phpinfo():创建一个名为info.php的PHP文件,内容如下:<?php phpinfo(); ?>,将该文件放置在Web服务器的根目录下(如/var/www/html),然后在浏览器中访问http://localhost/info.php,搜索“pdo_mysql”,如果看到相关条目,则说明扩展已成功安装。
-
使用PHP脚本测试:创建一个名为test_pdo.php的PHP文件,内容如下:
将该文件放置在Web服务器的根目录下,并在浏览器中访问http://localhost/test_pdo.php,如果看到“PDO_MYSQL连接成功!”的消息,则说明扩展已成功安装并可以正常使用。
常见问题及解决方案
问题 解决方案 安装过程中出现依赖错误 确保所有依赖项都已安装,并尝试使用包管理器的--fix-missing选项自动解决依赖问题。 PHP未加载PDO_MySQL扩展 检查php.ini文件中是否正确添加了extension=pdo_mysql.so,并确保该行未被注释,重启Web服务器后再次尝试。 PDO_MySQL连接失败 检查数据库连接参数(如主机名、用户名、密码、数据库名)是否正确,并确保MySQL服务正在运行。 通过以上步骤,你应该能够在Linux系统中成功安装并配置PDO_MySQL扩展,从而在PHP中使用PDO连接MySQL数据库,如果在安装过程中遇到任何问题,可以参考上述常见问题及解决方案进行
使用PECL安装
验证安装