PHP连接数据库所需驱动及安装教程

PHP连接数据库的关键并非安装传统意义上的“驱动”，而是正确启用或安装对应的扩展（extension），不同数据库类型和操作系统下操作差异显著：现代PHP已内置mysqli和PDO基础支持，但PostgreSQL、SQL Server等需手动配置——Ubuntu用apt一键安装，Windows需精准匹配DLL并解决运行时依赖，macOS则常需通过pecl配合环境变量绕过架构兼容陷阱；文章直击开发者最易踩坑的扩展启用盲区、配置遗漏与平台特异性问题，帮你避开“扩展未加载”“DLL架构不匹配”“pg_config找不到”等高频故障，真正实现开箱即连。

PHP 连接数据库不需要额外“装驱动”，而是要启用或安装对应的 extension（扩展），具体取决于你用的数据库类型和 PHP 版本。现代 PHP（7.4+）默认已内置 mysqli 和 PDO 扩展，但像 PostgreSQL、SQL Server、Oracle 等需手动启用或安装扩展。

确认当前 PHP 已启用哪些数据库扩展

运行 php -m 或创建一个 phpinfo() 页面，查找以下常见扩展名：

• mysqli：MySQL / MariaDB 原生接口（推荐用于简单场景）
• pdo + pdo_mysql / pdo_pgsql / pdo_sqlsrv：PDO 统一接口（推荐用于多数据库或 ORM 场景）
• pgsql：旧式 PostgreSQL 扩展（不推荐新项目使用）
• sqlsrv / pdo_sqlsrv：微软 SQL Server 官方扩展（Windows 下较稳定，Linux 需额外配置）

如果没看到对应扩展，说明未启用或未安装。

Linux（Ubuntu/Debian）下安装 MySQL/PgSQL 扩展

以 Ubuntu 22.04 + PHP 8.1 为例，直接用 apt 安装扩展包即可，不用编译：

• MySQL / MariaDB：sudo apt install php8.1-mysql（自动启用 mysqli 和 pdo_mysql）
• PostgreSQL：sudo apt install php8.1-pgsql（启用 pgsql 和 pdo_pgsql）
• 重启 Web 服务：sudo systemctl restart apache2 或 sudo systemctl restart php8.1-fpm

注意：php8.1-mysql 不包含 MySQLi 的完整客户端库，若连接时报 mysqlnd is not installed，需补装 php8.1-mysqlnd（多数系统已默认包含）。

Windows 下启用或安装 sqlsrv/pdo_sqlsrv（SQL Server）

微软官方扩展不随 PHP 发行版提供，必须手动下载 DLL 并配置：

• 去 GitHub releases 下载匹配 PHP 版本和线程安全（TS/NTS）、架构（x64/x86）的 php_sqlsrv_*.dll 和 php_pdo_sqlsrv_*.dll
• 把 DLL 放到 ext/ 目录（如 C:\php\ext\）
• 在 php.ini 中添加两行：
  extension=php_sqlsrv.dll
extension=php_pdo_sqlsrv.dll
• 重启 Web 服务后，用 php -m | findstr sqlsrv 验证是否加载成功

常见坑：Unable to load dynamic library 'php_sqlsrv.dll' 多因 DLL 与 PHP 架构不匹配（如 64 位 PHP 加了 32 位 DLL），或依赖的 msvcp140.dll / vcruntime140.dll 缺失（需安装 Microsoft Visual C++ Redistributable）。

macOS（M1/M2）用 Homebrew 装 pdo_pgsql 报错怎么办

Homebrew PHP（如 php@8.2）默认不带 PostgreSQL 扩展，且 macOS ARM 架构下编译易出错：

• 先确保 PostgreSQL 已安装：brew install postgresql
• 再重装 PHP 并启用 pgsql：brew reinstall php@8.2 --with-postgresql（新版 Homebrew 已弃用此参数）
• 更可靠做法：用 pecl 安装：pecl install pdo_pgsql，它会自动调用本地 pg_config
• 若报 command not found: pg_config，执行 export PATH="/opt/homebrew/opt/postgresql/bin:$PATH" 后重试

最后别忘了在 php.ini 中加 extension=pdo_pgsql —— pecl install 通常不会自动写入，这点极易漏掉。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。