php怎么连接本地mysql数据库服务器？,连接失败怎么办？

PHP连接本地MySQL数据库服务器的核心答案是：使用mysqli或PDO扩展，通过主机名、用户名、密码和数据库名四个参数建立连接。这是PHP开发中最基础也最关键的技能，掌握了它，你就打通了动态网站和数据处理之间的桥梁，下面我直接带你从零开始，把连接这件事彻底弄清楚。

动手前必看：PHP连接MySQL的环境准备

本地开发环境是第一步,行业共识认为，一个好的本地环境能帮你省掉后续百分之八十的麻烦，所谓”本地”，就是你的电脑同时扮演服务器和客户端的角色。

加载中

【PHP】教你10分钟快速学会php连接数据库

f

fitnessCoder

6.3万--

原视频地址

你需要安装Apache/Nginx、PHP和MySQL三个核心组件，对于新手，推荐使用集成环境包，比如phpStudy、XAMPP或者Laragon；如果你用的是Mac，MAMP也是不错的选择，这些工具把环境配置过程简化成”下一步、下一步”。

安装完成后,你先确认MySQL服务是否启动，Windows用户在phpStudy面板上一键启动即可，Mac用户可以通过brew services list命令查看MySQL运行状态，然后在浏览器地址栏输入http://localhost，如果能看到PHP的默认页面，说明Apache和PHP工作正常，整个过程像搭积木，每个组件各司其职，缺一不可。

php连接mysql数据库的两种主流方式

PHP提供了两种主要方式来连接MySQL：MySQLi扩展和PDO扩展，这不是选择题，而是根据你的项目需求做的判断题，下面我把它们的区别和适用场景掰开揉碎了讲。

面向过程的mysqli连接：新手入门首选

mysqli的面向过程写法非常直白,适合快速开发和理解连接逻辑，插上电源就能用，不需要太多前置知识。

<?php
$servername = "localhost";
$username = "root";
$password = "";
$dbname = "test_db";
// 创建连接
$conn = mysqli_connect($servername, $username, $password, $dbname);
// 检测连接
if (!$conn) {
    die("连接失败: " . mysqli_connect_error());
}
echo "连接成功";
mysqli_close($conn);
?>

这种写法最直观,mysqli_connect函数接受四个参数，按顺序分别是地址、用户名、密码、数据库名，成功时返回连接对象，失败时返回false。die语句会在连接失败时终止脚本并输出错误信息，这里有个细节：localhost和0.0.1在大多数本地环境下等效，但在某些系统上，localhost会走Unix套接字，0.0.1走TCP/IP，速度上可能有细微差别。

面向对象的PDO连接：多数据库兼容的首选

PDO是PHP Data Objects的缩写，它提供了一种统一的API来访问多种数据库系统，换个数据库不用改代码，这是它最大的价值。

<?php
$dsn = "mysql:host=localhost;dbname=test_db;charset=utf8mb4";
$username = "root";
$password = "";
try {
    $pdo = new PDO($dsn, $username, $password);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    echo "连接成功";
} catch (PDOException $e) {
    echo "连接失败: " . $e->getMessage();
}
?>

看到$dsn这个变量了吗？它是数据源名称，把数据库类型、主机地址、数据库名和字符集打包成一个字符串。try...catch是异常处理机制，比die更优雅不直接中断脚本，而是给你捕获错误的机会，这里我建议把字符集设为utf8mb4，因为它支持完整的Unicode字符，包括emoji表情和生僻字。

两种方式怎么选？如果你只跟MySQL打交道，用mysqli没问题；如果项目可能迁移数据库，或者你想学更通用的技能，直接PDO，业内专家指出，PDO在PHP 7+环境下性能与mysqli相当，但从长期维护的角度看，PDO更值得投资。

mysqli和PDO连接方式的详细对比

为了让你看得更清楚,我把这两种方式的区别整理成了表格，方便你对照着选型。

php连接本地mysql失败时该怎么排查

连接失败是每个开发者都会遇到的事,别慌，九成的问题出在下面这几个地方，按照排查清单一步步来，基本上能解决百分之九十九的故障。

最常见的坑是密码错误,MySQL安装时默认的root密码可能不是你想象的空密码，而是安装时你自己设置的那个，如果你用的是phpStudy，默认密码一般是root或者空，但不同版本有差异，最好去官方文档确认。

密码加密规则问题,MySQL 8.0默认使用caching_sha2_password加密方式，而老版本的PHP扩展可能不支持这种认证方式，解决方案有两个：一是升级PHP版本到7.4以上，二是把MySQL用户改为mysql_native_password加密，第二行的Unknown database错误也很常见，尤其是你还没创建数据库就去连接的时候，用phpMyAdmin或者命令行先把数据库建好，再执行连接代码。

php连接数据库的配置参数细节

真正专业的开发者不会把配置参数写死在代码里,但了解每个参数的含义仍然必要，连接配置里最常见的参数包括host、port、dbname、charset、timeout，它们的默认值分别是什么呢？

• host（主机名）：localhost或127.0.0.1，代表本机
• port（端口号）：默认3306，除非你安装时改了
• dbname（数据库名）：要连接的目标库
• charset（字符集）：建议utf8mb4，避免中文乱码
• timeout（超时时间）：连接超时，默认不限时

字符集的问题容易被忽略,但它在国内开发环境里特别重要，你连接成功后第一个要执行的SQL，通常就是SET NAMES utf8mb4，在PDO中你可以直接在DSN里加上charset=utf8mb4，在mysqli中用mysqli_set_charset($conn, "utf8mb4")，数据乱不乱码，就看你有没有设对这个参数。

端口号默认为3306,是MySQL的默认监听端口，如果你的机器上装了多个MySQL实例，或者你手动改了端口，那连接时就必须显式指定端口号，比如$conn = mysqli_connect("localhost", "root", "password", "dbname", 3307);。

提高PHP连接数据库效率的实践方法

连接数据库只是第一步,后续的查询操作才是重头戏，但连接本身也有优化空间，尤其是如果你在循环里反复建立连接，那就是性能灾难。

使用单例模式共享连接，就是让整个脚本生命周期内只有一个数据库连接实例，这在面向对象编程中非常实用，避免重复连接带来的开销。

设置合理的超时时间，本地环境连接很快，但在生产环境，数据库服务器可能负载较高或网络延迟大，如果你不设置超时时间，最坏情况下PHP脚本会一直等待数据库响应，最终触发PHP的最大执行时间限制。

关闭不必要的自动提交，如果你要做大量插入操作，可以在循环前关闭自动提交，循环结束后一次性提交，这样做能显著减少数据库的磁盘IO和锁竞争。

选择合适的数据库引擎，MySQL的InnoDB引擎支持事务处理和外键，MyISAM引擎在只读场景下有性能优势，连接数据库后，你可以用SHOW VARIABLES LIKE 'storage_engine';查看当前默认引擎，行业共识认为，业务型应用建议直接使用InnoDB，不需要额外考虑。

在命令行下测试连接是排查问题的常用手段,打开终端，输入mysql -u root -p，回车后输入密码，如果这个命令能成功进入MySQL命令行界面，说明MySQL服务本身没问题；如果不行，问题就出在MySQL端，而不是PHP代码上。

实战：php连接本地mysql的完整操作路径

理论说了一堆,我们来走一遍实操，这个流程你可以直接复制到你的本地环境里验证。

第一步：启动AMPA服务，打开phpStudy面板，点击”启动”按钮，看到Apache和MySQL的指示灯都变绿，说明服务就绪。

第二步：创建测试数据库，在phpMyAdmin中点击”新建”，输入数据库名test_db，排序规则选择utf8mb4_general_ci，点击创建，数据库就建好了。

第三步：创建数据表并插入测试数据，在SQL选项卡中执行下面的SQL语句：

CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(50) NOT NULL,
    email VARCHAR(100) NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
INSERT INTO users (username, email) VALUES ('admin', 'admin@example.com');

第四步：在网站根目录创建一个名为connect.php的文件，写入上面的PDO连接代码，浏览器访问http://localhost/connect.php，成功的话页面上会显示”连接成功”。

这套流程走通后,你就掌握了php连接本地mysql数据库的核心链路，剩下的事情增删改查、预处理、事务处理都是在这个连接之上展开的。

php连接本地mysql数据库,本质上就是确认”我是谁、我要连到哪、我要访问哪份数据”这三件事，把mysqli或PDO两个函数写熟练，把常见报错记在心里，你的PHP开发之路就畅通了一大半，技术没有捷径，多敲几次代码，多踩几个坑，自然就熟练了。

相关问题解答

php连接mysql数据库时端口号写错会有什么表现？

连接会抛出一个“`
connect time out

的异常，或者在mysqli中返回连接失败的信息，因为MySQL默认监听3306端口，如果你写了3307或者其他端口，MySQL服务根本不会响应你的请求，排查方式是检查MySQL的配置文件`my.ini`中的`port`设置，确保两个地方一致。
### MySQL 8.0默认认证方式和PHP不兼容怎么办？
在MySQL命令行中执行以下SQL语句把用户的认证插件改为mysql_native_password：
```sql
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码';
FLUSH PRIVILEGES;

执行完成后重新连接即可,这是MySQL 8.0发布后很多开发者踩过的坑，属于PHP和MySQL版本兼容性问题，以上方法可以彻底解决。