“Connection refused”表明PHP未触达MySQL服务端，需依次检查MySQL服务状态、bind_address与DB_HOST匹配性、PDO MySQL扩展启用情况、防火墙/SELinux拦截，并用终极命令验证通路。
PHP8项目启动时提示“Connection refused”，说明PHP进程根本没触达MySQL服务端，不是密码错也不是权限问题，而是网络通路或服务状态层面的阻断。
确认MySQL服务是否真正运行
执行 systemctl status mysql（Linux）或打开phpstudy_pro主界面看MySQL服务状态灯是否为绿色；若显示inactive或未启动，直接运行 sudo systemctl start mysql 或在phpstudy中点击“启动”按钮。
Mac用户用Homebrew安装的需执行 brew services list | grep mysql，状态非started则运行 brew services start mysql。
注意：Docker环境必须额外验证容器是否运行且端口映射正确——执行 docker ps 确认有mysql容器，且PORTS列包含 0.0.0.0:3306->3306/tcp，缺一不可。
立即学习“PHP免费学习笔记（深入）”；
检查PHP连接参数与MySQL监听地址是否匹配
第一步：登录MySQL执行 SELECT @@bind_address;，若返回 127.0.0.1，则MySQL只接受TCP本机回环连接，localhost 会走socket被绕过；若返回 * 或 0.0.0.0，说明监听所有地址。
第二步：核对PHP配置中的 DB_HOST。若MySQL bind_address是 127.0.0.1，PHP里必须写 127.0.0.1，写 localhost 就会失败；反之若MySQL只监听socket（常见于MAMP/XAMPP），则PHP必须写 localhost 并确保 DB_PORT 为空或设为0。
第三步：用命令行直连验证，执行 mysql -h 127.0.0.1 -P 3306 -u your_user -p，能登录说明网络和端口通，不能登录就卡在上一步。
验证PDO MySQL驱动是否启用
执行 php -r "var_dump(PDO::getAvailableDrivers());"，输出数组中必须包含 mysql 字符串。
若无mysql，编辑php.ini，取消注释 extension=pdo_mysql（注意不是pdo.so），保存后重启Web服务或PHP-FPM进程。
Windows用户还需确认 extension_dir 指向正确的ext目录，路径错误会导致扩展加载静默失败。
排查防火墙与SELinux拦截（Linux生产环境专用）
方法一：临时关闭防火墙测试，CentOS/RHEL执行 sudo systemctl stop firewalld，Ubuntu执行 sudo ufw disable；若此时PHP连接成功，说明原规则阻断了3306端口，需添加放行规则。
方法二：检查SELinux状态，执行 sestatus，若为enforcing，运行 sudo setsebool -P httpd_can_network_connect_db 1 允许Web进程访问数据库端口。
注意：SELinux策略修改后无需重启服务，但firewalld关闭后必须重启PHP-FPM或Apache才能生效。
快速验证连接通路的终极命令
在项目根目录下执行：php -r "\$dsn='mysql:host=127.0.0.1;port=3306;dbname=information_schema;charset=utf8mb4';\$pdo=new PDO(\$dsn,'root','your_password');echo 'OK';"
把 your_password 替换为你的真实密码，host/port按实际配置调整；输出OK表示底层通路完全正常，问题一定出在框架配置层；报错则按错误信息反向定位。
