PHP中如何通过Unix Socket连接数据库_优化本地连接性能-php教程-PHP中文网

Unix Socket连接MySQL必须显式使用unix_socket参数，如"mysql:unix_socket=/var/run/mysqld/mysqld.sock;dbname=test"；host设为localhost或127.0.0.1均不可靠，前者可能触发DNS解析，后者强制走TCP。

php中如何通过unix socket连接数据库_优化本地连接性能

Unix Socket连接MySQL的DSN写法必须用`unix_socket`参数

PHP中PDO连接MySQL走Unix Socket，不能靠把host设成localhost或127.0.0.1来“碰运气”——前者在某些PHP版本里会触发DNS解析，后者强制走TCP。唯一可靠的方式是显式使用unix_socket参数：

$pdo = new PDO(
    "mysql:unix_socket=/var/run/mysqld/mysqld.sock;dbname=test",
    $user,
    $pass,
    [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]
);

unix_socket是PDO MySQL驱动识别Unix Socket的**唯一合法键名**，拼错（如socket、unixsocket）会导致静默降级为TCP连接
路径必须与MySQL实际监听路径完全一致，常见位置有/var/run/mysqld/mysqld.sock（Debian/Ubuntu）、/tmp/mysql.sock（macOS或源码编译安装）
如果MySQL配置了skip-networking，TCP连接会被禁用，但Unix Socket仍可用；此时unix_socket是唯一可行路径

MySQLi连接Unix Socket时host和port必须设为null

MySQLi构造函数对参数更敏感，host和port的值直接决定底层是否启用Socket模式：

$mysqli = new mysqli(
    null,        // host → 必须为 null 或空字符串
    $user,
    $pass,
    'testdb',
    null,        // port → 必须为 null
    '/var/run/mysqld/mysqld.sock'  // 第6个参数：sock路径
);

若host填'localhost'，MySQLi会尝试Unix Socket，但受系统glibc配置影响，可能 fallback 到IPv6解析，引发延迟
若host填'127.0.0.1'或port设为3306，则**必定走TCP**，unix_socket参数无效（MySQLi不支持该参数）
第6个参数是唯一指定Socket路径的位置，漏掉或传错类型（如传整数）会导致mysqli_connect_error()返回空字符串

权限问题常被忽略：PHP进程用户必须能读写Socket文件及其父目录

即使DSN和路径都正确，PDOException报错Connection refused或No such file or directory，大概率是权限卡住：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

Socket文件本身需有读写权限（如srw-rw----），且属组包含PHP运行用户（如www-data）
父目录（如/var/run/mysqld/）必须对PHP用户**可执行（x）**，否则无法进入目录访问socket文件
Docker中必须显式挂载Socket文件（-v /var/run/mysqld/mysqld.sock:/var/run/mysqld/mysqld.sock），且挂载后UID/GID需匹配，否则容器内PHP进程无权访问
临时验证方式：sudo -u www-data mysql -S /var/run/mysqld/mysqld.sock -e "SELECT 1;"，成功说明权限无问题

MySQL用户权限必须匹配`@localhost`而非`@'%'`

通过Unix Socket连接时，MySQL服务端**永远将客户端视为localhost来源**，与IP无关。这意味着：

数据库用户必须显式授权给username@localhost，而不是username@'%'或username@'127.0.0.1'
执行GRANT ALL ON test.* TO 'user'@'localhost' IDENTIFIED BY 'pass'; FLUSH PRIVILEGES;才有效
若只创建了user@'%'，连接会报错Access denied for user 'user'@'localhost'，这是最典型的权限误配现象
注意：MySQL 8.0+默认认证插件改为caching_sha2_password，老版本PHP可能不兼容，必要时加ALTER USER 'user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'pass';

Unix Socket连接看似只是改个路径，但涉及MySQL配置、PHP驱动行为、Linux文件权限、MySQL权限模型四层耦合。任意一层断开，都会表现为“连不上”或“连得慢”，而错误信息往往模糊——比如Connection refused可能是路径错、权限缺、用户没授权，甚至MySQL根本没在监听那个socket。