PHP连接MySQL配置全攻略

本文深入解析了PHP连接MySQL数据库的完整配置流程，涵盖扩展启用、三种主流连接方式（MySQLi面向过程/面向对象及PDO）的代码实现与错误处理技巧，并强调了服务状态、用户权限、主机绑定等关键服务端配置的排查要点，帮助开发者系统性解决连接失败问题，快速构建稳定可靠的数据库交互环境。

如果您在开发PHP应用程序时需要与MySQL数据库进行交互，但无法成功建立连接，则可能是由于数据库连接参数配置错误或扩展未启用。以下是配置PHP数据库连接的具体方法：

一、检查并启用MySQLi或PDO扩展

PHP默认不自动启用MySQL相关扩展，必须确保php.ini中已加载MySQLi或PDO MySQL扩展，否则调用连接函数会报错。

1、打开PHP安装目录下的php.ini文件。

2、查找extension=mysqli和extension=pdo_mysql两行，确认其前面没有分号（;）注释符。

3、若被注释，删除每行开头的分号。

4、保存php.ini文件后，重启Web服务器（如Apache或Nginx）使配置生效。

5、创建一个PHP文件，写入并访问，搜索“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）。

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或注释该行。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~