thinkphp不支持dsn中直接写unix_socket参数，必须通过params配置pdo::mysql_attr_unix_socket常量或mysqli驱动的socket字段实现unix socket连接，且需确保路径权限正确。
ThinkPHP不支持用DSN写unix_socket参数
ThinkPHP的Db::connect()或配置文件加载机制，**根本不解析unix_socket这个键**。你往DSN里塞mysql:unix_socket=/var/run/mysqld/mysqld.sock;dbname=test，框架会直接忽略unix_socket，然后 fallback 到默认 TCP 行为——结果就是报No such file or directory或Connection refused，但错误信息完全不提示“你写的socket参数被无视了”。
原因很简单：ThinkPHP 的 DSN 解析器只认标准 URL 格式（如mysql://user:pass@host:port/db#charset），不兼容 PDO 原生 DSN 语法。它把mysql:xxx当非法前缀直接截断，后面全丢弃。
- 别在
database.php里写'dsn' => 'mysql:unix_socket=...'，无效 - 别在
.env里写DB_DSN=mysql:unix_socket=...，ThinkPHP 8.0+ 默认不读这个变量 - DSN 方式只适合临时脚本测试，生产环境必须走标准字段配置
PDO连接Unix Socket必须显式传unix_socket参数
要让 PDO 底层真正走 Unix Socket，唯一办法是绕过 ThinkPHP 的 DSN 解析，**把unix_socket作为 PDO 构造参数透传进去**。ThinkPHP 提供了params配置项来干这事：
在config/database.php的 MySQL 连接配置里，加这一段：
'params' => [
\PDO::MYSQL_ATTR_UNIX_SOCKET => '/var/run/mysqld/mysqld.sock',
],
注意：\PDO::MYSQL_ATTR_UNIX_SOCKET是 PHP 内置常量，值为1004，不能手写字符串'unix_socket'，也不能拼错成MYSQL_ATTR_SOCKET。
-
hostname字段必须留空或设为null，设成'localhost'或'127.0.0.1'会干扰底层判断 - 路径必须和
mysql -S /path/to/socket能连上的完全一致，常见位置：/var/run/mysqld/mysqld.sock（Debian/Ubuntu）、/tmp/mysql.sock（macOS/Homebrew） - 如果用了 Docker，宿主机 socket 路径在容器内不可见，必须挂载且确保 UID/GID 匹配，否则
Permission denied
MySQLi模式下host和port必须为null
ThinkPHP 支持切换数据库驱动类型，设'type' => 'mysqli'后，底层用mysqli扩展而非 PDO。这时 Unix Socket 的触发逻辑完全不同：
必须同时满足三个条件：
-
'hostname' => null或''（不能是'localhost'） -
'hostport' => null（TP6/8 是hostport字段，不是port） -
'socket' => '/var/run/mysqld/mysqld.sock'（注意键名是socket，不是unix_socket）
漏掉任意一个，mysqli就会 fallback 到 TCP。比如hostname填'localhost'，某些 glibc 版本会先尝试 IPv6 解析，超时后再试 socket，导致明显延迟。
验证是否真走 socket：在 MySQL 里执行SHOW PROCESSLIST;，看你的连接的Host列是不是localhost（TCP 下通常是127.0.0.1或::1）。
权限和路径问题比配置错误更常见
90% 的No such file or directory错误，其实不是路径写错，而是 PHP 进程没权限访问 socket 文件或其父目录。
检查三件事：
- socket 文件本身权限：运行
ls -l /var/run/mysqld/mysqld.sock，输出类似srw-rw---- 1 mysql www-data，其中www-data（或nginx、apache）必须是 PHP 进程用户 - 父目录可执行权限：
/var/run/mysqld/必须有x位（即drwxr-x---这类），否则 PHP 进不了目录，报错和文件不存在一样 - Docker 挂载后 UID 不匹配：宿主机
mysqld.sock属主是999:999，容器内 PHP 用户是82:82，得用chown 82:82 /var/run/mysqld/mysqld.sock修复
最简单的验证方式：切到 PHP 进程用户身份，手动执行mysql -S /path/to/socket -u user -p，能连上才说明路径和权限都对。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
