初学者学php如何连接数据库_初学者学php连mysql方法【实操】

2026-01-19

初学者学php如何连接数据库_初学者学php连mysql方法【实操】

最稳妥推荐的PHP连MySQL方式是PDO，需启用pdo和pdo_mysql扩展，连接时必须设置charset=utf8mb4和PDO::ATTR_ERRMODE=>PDO::ERRMODE_EXCEPTION，排查连接失败要依次检查MySQL服务状态、用户权限和host/port配置。

初学者学php如何连接数据库_初学者学php连mysql方法【实操】

PHP 连 MySQL 最稳妥、推荐的方式是用 PDO，不是 mysql_connect()（已彻底废弃），也不是 mysqli_connect()（虽可用但面向过程写法易出错）。PDO 支持预处理、多数据库切换、错误模式可控，初学者从它起步反而更少踩坑。

确认 PHP 环境已启用 PDO 和 pdo_mysql 扩展

很多新手本地跑不起来，根本原因是扩展没开。执行以下命令检查：

php -m | grep -i pdo

应看到 pdo 和 pdo_mysql。若没有：

Windows（XAMPP/WAMP）：打开 php.ini，取消注释这两行：
;extension=php_pdo.dll → 改为 extension=php_pdo.dll
;extension=php_pdo_mysql.dll → 改为 extension=php_pdo_mysql.dll
macOS（Homebrew + php@8.2）：brew install php@8.2 默认已含，检查 /opt/homebrew/etc/php/8.2/php.ini 中是否有 extension=pdo_mysql
Linux（Ubuntu）：sudo apt install php-mysql，然后确认 /etc/php/*/apache2/conf.d/10-pdo.ini 和 20-mysqlnd.ini 存在且未被注释

用 PDO 连接 MySQL 的最小可运行代码

别抄网上带 try-catch 但没设 PDO::ATTR_ERRMODE 的“半残”示例——那会静默失败。下面这段能立刻暴露连接问题：

立即学习“PHP免费学习笔记（深入）”；

PHP高级开发技巧与范例

PHP是一种功能强大的网络程序设计语言，而且易学易用，移植性和可扩展性也都非常优秀，本书将为读者详细介绍PHP编程。
全书分为预备篇、开始篇和加速篇三大部分，共9章。预备篇主要介绍一些学习PHP语言的预备知识以及PHP运行平台的架设；开始篇则较为详细地向读者介绍PKP语言的基本语法和常用函数，以及用PHP如何对MySQL数据库进行操作；加速篇则通过对典型实例的介绍来使读者全面掌握PHP。
本书

下载

try {
$pdo = new PDO("mysql:host=$host;dbname=$dbname;charset=utf8mb4", $username, $password, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);
echo "✅ 连接成功";
} catch (PDOException $e) {
echo "❌ 连接失败：" . $e->getMessage();
}
?>

关键点：

charset=utf8mb4 必须显式声明，否则中文存入可能变问号或乱码
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION 是核心，没它就等于“把错误吞掉”
密码为空时不要传 null 或省略，必须传空字符串 ''
如果报 SQLSTATE[HY000] [1045] Access denied，先用命令行验证账号密码：mysql -u root -p

连接失败的三个高频原因和对应检查项

90% 的“连不上”问题集中在这三处，按顺序排查：

MySQL 服务根本没运行：Mac 执行 brew services list | grep mysql，Linux 执行 sudo systemctl status mysql，Windows 检查 XAMPP 控制面板里 MySQL 是否显示 “Running”
用户权限不足：默认 root@localhost 可能只允许 socket 连接。用命令行登录后执行：
```
CREATE USER 'phpuser'@'localhost' IDENTIFIED BY 'pass123';
GRANT ALL ON testdb.* TO 'phpuser'@'localhost';
FLUSH PRIVILEGES;
```
，然后代码里改用这个新用户
端口或 host 写错：Docker 环境常见问题。若 MySQL 在容器中，host 不能写 localhost（它指向 PHP 容器自身），得写宿主机 IP 或 Docker 网络别名如 mysql；本地 MAMP 用户注意端口是否被改成 8889，则 DSN 要写成 mysql:host=localhost;port=8889;dbname=...

真正难的不是写那几行连接代码，而是当页面只显示空白或 500 错误时，你能否快速定位是 PHP 配置、MySQL 服务、网络通路，还是权限策略的问题。建议第一次成功后，立刻在代码里加一句 var_dump($pdo->getAttribute(PDO::ATTR_SERVER_VERSION));，亲眼看到版本号，才算真正“握住了手”。

https://www.php.cn/faq/2004275.html