在xampp环境下，php连接本地mysql数据库最稳妥的方式是使用pdo扩展并指定`unix_socket`参数。通过直接连接`/opt/lampp/var/mysql/mysql.sock`（linux）或`c:\xampp\mysql\tmp\mysql.sock`（windows），可以绕过tcp/ip协议栈，减少网络开销并避免端口冲突。只需将主机名设为socket路径，用户名和密码保持默认即可建立连接。
如何配置PDO以使用Unix Socket连接
使用PDO连接时，DSN字符串中必须包含`unix_socket`选项。这要求PHP的PDO_MySQL驱动已启用，且XAMPP中的MySQL服务正在运行。这种方式比使用`127.0.0.1`更可靠，因为后者会强制走TCP连接，可能受到防火墙或MySQL配置中`skip-networking`的影响。
$host = 'localhost';
$db = 'test_db';
$user = 'root';
$pass = '';
// Windows XAMPP 路径示例
$socket = 'C:/xampp/mysql/tmp/mysql.sock';
// Linux/Mac XAMPP 路径示例
// $socket = '/opt/lampp/var/mysql/mysql.sock';
$dsn = "mysql:host=$host;dbname=$db;unix_socket=$socket";
try {
$pdo = new PDO($dsn, $user, $pass);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
echo "Connected successfully";
} catch (PDOException $e) {
echo "Connection failed: " . $e->getMessage();
}
为什么不建议使用127.0.0.1作为主机名
当在PHP代码中将主机名设置为`127.0.0.1`时，MySQL客户端库会忽略socket文件，转而尝试通过TCP/IP协议连接到本地回环接口的3306端口。如果XAMPP的MySQL配置中禁用了TCP连接（例如设置了`skip-networking`），或者本地防火墙阻止了该端口，连接就会失败。而使用`localhost`（不带IP）通常会优先尝试socket连接，但在某些PHP版本或配置下行为可能不一致，显式指定`unix_socket`是最明确的做法。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
立即学习“PHP免费学习笔记（深入）”；
// 错误示范：强制走TCP，可能失败
$dsn_tcp = "mysql:host=127.0.0.1;dbname=test_db";
// 正确示范：显式指定Socket
$dsn_sock = "mysql:host=localhost;dbname=test_db;unix_socket=C:/xampp/mysql/tmp/mysql.sock";
try {
// 测试TCP连接
$pdo_tcp = @new PDO($dsn_tcp, 'root', '');
if ($pdo_tcp) echo "TCP OK"; else echo "TCP Fail";
} catch (Exception $e) {
echo "TCP Error";
}
try {
// 测试Socket连接
$pdo_sock = new PDO($dsn_sock, 'root', '');
if ($pdo_sock) echo "Socket OK"; else echo "Socket Fail";
} catch (Exception $e) {
echo "Socket Error";
}
如何处理连接超时或权限拒绝错误
如果在执行上述代码时遇到`Access denied`错误，通常是因为XAMPP默认的用户名是`root`且密码为空，但你可能修改过密码。如果遇到`Can't connect to local MySQL server through socket`，请检查socket文件路径是否正确。在Windows上，XAMPP的MySQL临时目录可能在`C:\xampp\mysql\tmp\`，而在Linux上通常在`/opt/lampp/var/mysql/`。确保PHP进程有权限读取该socket文件。此外，可以在XAMPP控制面板中重启MySQL服务，以确保socket文件被正确创建。
