PHP连LNMP的MySQL必须用127.0.0.1而非localhost，因后者强制走Unix socket而路径不匹配；需确认mysqli/pdo_mysql已启用、用户授权为'@127.0.0.1'、端口正确，并查error_log定位具体错误。
LNMP 环境下 PHP 连不上 MySQL，90% 是配置没对上——不是 PHP 没装 mysqli 或 pdo_mysql 扩展，就是连接参数写成了本地 localhost 而非 LNMP 默认的 Unix socket 或 127.0.0.1。
PHP 连 LNMP 的 MySQL 必须用 127.0.0.1，不能用 localhost
LNMP 默认关闭了 MySQL 的 TCP/IP 远程访问（bind-address = 127.0.0.1），但更关键的是：当 PHP 使用 localhost 作为主机名时，MySQL 客户端库会强制走 Unix socket（/tmp/mysql.sock），而 LNMP 的 MySQL socket 路径通常是 /usr/local/mysql/tmp/mysql.sock 或 /var/run/mysqld/mysqld.sock，PHP 默认找不到。
- ✅ 正确写法：
$host = '127.0.0.1';（走 TCP，绕过 socket 路径问题） - ❌ 错误写法：
$host = 'localhost';（触发 socket 连接，大概率报Can't connect to local MySQL server through socket） - 若坚持用 socket，必须显式指定路径：
$host = 'localhost'; $socket = '/usr/local/mysql/tmp/mysql.sock';，并在mysqli构造时传入['socket' => $socket]选项（PDO 不支持直接传 socket，得改php.ini的mysql.default_socket）
确认 PHP 已启用 mysqlnd 或 pdo_mysql 扩展
LNMP 一键包默认编译 PHP 时已启用 mysqli 和 pdo_mysql，但如果你自己重编译过或用了精简版，可能被关掉。运行 php -m | grep mysql，应看到 mysqli 和 pdo_mysql；若没有，进 LNMP 目录执行 ./lnmp php-extension-install mysqli（具体命令依版本而定）。
- 检查扩展是否加载：
php -i | grep "mysql.default_socket"，有输出说明扩展就位 - 注意：LNMP 的 PHP 通常不依赖系统自带的
libmysqlclient，而是用mysqlnd（原生驱动），所以不用装mysql-devel类包 -
pdo_mysql和mysqli可共存，选一个用即可；Laravel 默认走 PDO，Typecho/WordPress 常用 mysqli
连接代码里别漏掉端口和用户权限
LNMP 的 MySQL 默认端口是 3306，但如果你改过 /usr/local/mysql/my.cnf 中的 port，PHP 连接时就得显式指定，否则仍连 3306——而 MySQL 其实监听在别的端口上。
立即学习“PHP免费学习笔记（深入）”；
- 显式写端口：
$host = '127.0.0.1'; $port = 3306;，然后在mysqli中用new mysqli($host, $user, $pass, $db, $port) - 用户必须授权给
'user'@'127.0.0.1'（不是'user'@'localhost'），因为你是用 IP 连的；执行GRANT ALL ON *.* TO 'your_user'@'127.0.0.1' IDENTIFIED BY 'pwd'; FLUSH PRIVILEGES; - 密码为空时，
mysqli会把空字符串当成 null 处理，导致认证失败；确保$password = ''是字符串而非null
调试连不上时，优先看 error_log 而不是浏览器白屏
LNMP 的 PHP 错误默认不显示在页面，而是记在 /usr/local/php/var/log/php-fpm.log 或网站的 error.log（如 /home/wwwlogs/your-site.error.log）。打开 php.ini 中的 display_errors = On 和 error_reporting = E_ALL 只用于开发机，生产环境务必关掉。
- 快速验证连接：
php -r "var_dump(new mysqli('127.0.0.1', 'root', '', 'mysql', 3306));" - 如果报
Connection refused，说明 MySQL 没起来：lnmp mysql start - 如果报
Access denied，八成是用户权限或密码错；用mysql -u root -p -h 127.0.0.1命令行试一遍，结果一致就排除 PHP 问题
真正卡住人的地方，往往不是语法或扩展，而是 localhost 和 127.0.0.1 在 MySQL 协议层的语义差异，以及 LNMP 对 socket 路径的定制化处理——这两点不厘清，换十种写法都连不上。
