php怎么连接mysql数据库_php连接mysql数据库基础教程【步骤】

PHP连接MySQL应使用mysqli或PDO,禁用已废弃的mysql_connect();mysqli面向对象写法需传入主机、用户、密码、库名四参数并设utf8mb4字符集;PDO需在DSN中指定charset并启用异常模式。

PHP 连接 MySQL 数据库,优先用 mysqliPDO,别碰已废弃的 mysql_connect() —— 它在 PHP 7.0+ 中彻底消失,强行用会直接报错 Fatal error: Uncaught Error: Call to undefined function mysql_connect()

怎么用 mysqli 连接 MySQL(面向对象写法)

这是目前最常用、推荐的连接方式,语法清晰、支持预处理、错误提示明确。

  • 确保 PHP 已启用 mysqli 扩展(检查 phpinfo() 中是否有 mysqli 模块,或运行 extension=php_mysqli.dll(Windows)/extension=mysqli.so(Linux)是否在 php.ini 中开启)
  • 连接时必须传入主机、用户名、密码、数据库名四个参数,端口和字符集建议显式指定
  • 连接失败不会自动抛异常,需手动检查 $mysqli->connect_error 或用 @ 抑制警告后判断 $mysqli->connect_errno
$mysqli = new mysqli('localhost', 'root', 'password', 'testdb', 3306);
if ($mysqli->connect_error) {
    die('连接失败:' . $mysqli->connect_error);
}
$mysqli->set_charset('utf8mb4'); // 强烈建议设为 utf8mb4,避免 emoji 和生僻字乱码

怎么用 PDO 连接 MySQL(更灵活、支持多种数据库)

PDO 更适合需要切换数据库类型(如从 MySQL 换到 PostgreSQL)或强调统一错误处理的项目。它默认不开启异常模式,这

点容易被忽略。

  • DSN 字符串格式为 mysql:host=localhost;dbname=testdb;charset=utf8mb4charset 必须写在 DSN 里才生效,单独调 setCharset 无效
  • 必须设置 PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,否则 SQL 错误只会返回 false,难以调试
  • 密码等敏感信息建议从环境变量读取,而不是硬编码在 DSN 中
try {
    $pdo = new PDO('mysql:host=localhost;dbname=testdb;charset=utf8mb4', 'root', 'password', [
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    ]);
} catch (PDOException $e) {
    die('连接失败:' . $e->getMessage());
}

为什么连不上?常见卡点排查

不是代码写错,而是环境或权限问题占八成。先看这些再改代码:

  • MySQL 服务没启动:运行 systemctl status mysql(Linux)或检查 Windows 服务列表里的 MySQL80
  • 用户无远程访问权限:默认 root@localhost 不能从 PHP(哪怕本机)用 127.0.0.1 连,得建用户 CREATE USER 'webuser'@'127.0.0.1' IDENTIFIED BY 'pwd'; GRANT ALL ON testdb.* TO 'webuser'@'127.0.0.1';
  • 防火墙/SELinux 拦截:Linux 下确认 3306 端口未被屏蔽;Mac M1 用户注意 MySQL 是否跑在 Rosetta 模式下导致 socket 路径异常
  • PHP 和 MySQL 版本不兼容:MySQL 8.0 默认用 caching_sha2_password 认证插件,老版本 PHP(ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password';

连接后立刻要做的事:验证、设字符集、关持久连接

很多人连上就查数据,结果中文变问号、特殊符号报错、高并发下连接数爆满——都是因为漏了这几步。

  • $mysqli->ping()$pdo->getAttribute(PDO::ATTR_CONNECTION_STATUS) 主动验证连接有效性,尤其在长生命周期脚本中
  • utf8mb4 不是可选项,是必须项。MySQL 的 utf8 实际只支持 3 字节 UTF-8,存不了 emoji 和部分汉字(如 ?、?)
  • 不要滥用 PDO::ATTR_PERSISTENTmysqli::real_connect()MYSQLI_CLIENT_FOUND_ROWS 等非常规标志,除非你清楚它们对连接池和事务的影响

真正麻烦的从来不是“怎么连”,而是“连上之后怎么不出错”——字符集、权限粒度、连接生命周期、错误传播方式,每个都得按实际部署环境校准,而不是照抄教程里的四行代码。