PHP连接MySQL失败需依次检查：一、启用mysqli或PDO扩展并重启服务器；二、用mysqli面向过程/对象方式或PDO连接，注意参数与错误处理；三、验证MySQL服务、用户权限及bind-address配置。
如果您在开发PHP应用程序时需要与MySQL数据库进行交互，但无法成功建立连接，则可能是由于数据库连接参数配置错误或扩展未启用。以下是配置PHP数据库连接的具体方法：
一、检查并启用MySQLi或PDO扩展
PHP默认不自动启用MySQL相关扩展，必须确保php.ini中已加载MySQLi或PDO MySQL扩展，否则调用连接函数会报错。
1、打开PHP安装目录下的php.ini文件。
2、查找extension=mysqli和extension=pdo_mysql两行，确认其前面没有分号（;）注释符。
立即学习“PHP免费学习笔记（深入）”；
3、若被注释，删除每行开头的分号。
4、保存php.ini文件后，重启Web服务器（如Apache或Nginx）使配置生效。
5、创建一个PHP文件，写入<?php phpinfo(); ?>并访问，搜索“mysqli”和“pdo_mysql”，确认模块已加载。
二、使用MySQLi面向过程方式连接
MySQLi扩展提供面向过程和面向对象两种接口，面向过程方式适合简单脚本，通过函数直接传入连接参数完成初始化。
1、定义数据库主机、用户名、密码、数据库名变量，例如：$host = "localhost"; $user = "root"; $pass = ""; $db = "test";
2、调用mysqli_connect()函数，传入四个参数：$conn = mysqli_connect($host, $user, $pass, $db);
3、使用mysqli_connect_error()检测是否连接失败，如返回非空字符串则说明连接异常。
4、若连接成功，可执行查询语句，例如：mysqli_query($conn, "SELECT * FROM users");
5、操作完成后调用mysqli_close($conn)关闭连接。
三、使用MySQLi面向对象方式连接
面向对象方式将连接封装为MySQLi类实例，支持更清晰的错误处理和链式调用，适用于结构化项目。
1、使用new mysqli()构造函数，按顺序传入主机、用户名、密码、数据库名和端口（端口可选，默认3306）。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
2、示例：$mysqli = new mysqli("localhost", "root", "", "test");
3、检查$mysqli->connect_error属性是否为null，若不为null则表示连接失败。
4、成功后可通过$mysqli->query()执行SQL语句，如：$mysqli->query("INSERT INTO logs (msg) VALUES ('init')");
5、连接不再需要时，调用$mysqli->close()释放资源。
四、使用PDO方式连接MySQL
PDO是PHP数据对象接口，支持多种数据库驱动，具有预处理语句和异常模式等高级特性，适合需要数据库移植性的应用。
1、构造DSN（数据源名称），格式为"mysql:host=localhost;dbname=test;charset=utf8mb4"，注意指定字符集避免乱码。
2、调用PDO构造函数，传入DSN、用户名、密码及可选选项数组，例如：$pdo = new PDO($dsn, $user, $pass, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
3、设置PDO::ATTR_ERRMODE为PDO::ERRMODE_EXCEPTION可让错误抛出异常，便于捕获处理。
4、使用$pdo->prepare()和$pdo->execute()执行带参数的SQL，防止SQL注入。
5、PDO连接在对象销毁时自动关闭，也可显式调用$pdo = null释放引用。
五、验证连接参数与权限配置
即使PHP扩展启用且代码语法正确，仍可能因MySQL服务状态或用户权限问题导致连接拒绝，需单独排查服务端配置。
1、确认MySQL服务正在运行，Linux下执行systemctl status mysqld，Windows下检查服务列表中MySQL是否启动。
2、登录MySQL命令行，执行SELECT User, Host FROM mysql.user;查看用户授权范围，特别注意Host字段是否允许从PHP所在主机（如%或具体IP）连接。
3、若用户Host为localhost，则仅接受Unix socket或127.0.0.1本地回环连接；远程连接需对应Host设为%或目标IP。
4、执行GRANT ALL PRIVILEGES ON test.* TO 'root'@'%' IDENTIFIED BY 'password'; FLUSH PRIVILEGES;授予必要权限。
5、检查MySQL配置文件my.cnf中bind-address是否限制为127.0.0.1，如需远程访问应改为0.0.0.0或注释该行。
