PHP CLI执行MySQL查询需先确认连接配置:显式指定host/port/socket,启用对应扩展,验证凭据权限;用mysqli_query()或PDO::query()时须检查返回值、防注入、设字符集,并显式关闭连接。

PHP CLI 执行 MySQL 查询前必须确认连接方式
CLI 环境下没有 Web 服务器的自动配置,mysqli 或 PDO 连接失败几乎全是因凭据或网络配置缺失导致。别直接套用 localhost —— 它在 CLI 中可能解析为 127.0.0.1(走 TCP),也可能走 Unix socket,而你的 MySQL 可能只监听 socket 或只允许特定 host。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 用
mysql -u root -p -h 127.0.0.1先手动验证能否连上,确认端口(默认 3306)和用户权限是否对 - PHP 脚本中显式指定
host、port、unix_socket(如需),避免依赖 DNS 解析 - 检查 CLI 使用的
php.ini:运行php --ini,确保extension=mysqli或extension=pdo_mysql已启用(CLI 和 FPM 的 ini 文件常不同)
用 mysqli_query() 在 CLI 中安全执行单条查询
mysqli_query() 可以直接执行 SELECT/INSERT/UPDATE,但 CLI 下无自动错误处理,不加判断就静默失败。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 必须检查返回值:
if (!$result = mysqli_query($conn, $sql)) { die('Error: ' . mysqli_error($conn)); } - SELECT 查询后,用
mysqli_fetch_all($result, MYSQLI_ASSOC)获取关联数组,别直接print_r($result)(它只是个 resource) - 非 SELECT 语句(如 INSERT)要改用
mysqli_affected_rows($conn)判断是否生效,而非试图 fetch - SQL 字符串里含变量时,务必用
mysqli_real_escape_string()或预处理语句,CLI 不代表可跳过防注入
用 PDO::query() 更简洁,但要注意默认异常模式
PDO::query() 返回 PDOStatement 对象,比 mysqli 更易读,但默认不抛异常 —— 错误会静默返回 false,容易漏判。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 初始化 PDO 时强制开启异常模式:
new PDO($dsn, $user, $pass, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]) - 简单查询可直接
$stmt = $pdo->query("SELECT * FROM users"); $rows = $stmt->fetchAll(PDO::FETCH_ASSOC); - 带参数的查询必须用
prepare()+execute(),query()不支持占位符绑定 - 注意 DSN 中的
charset=utf8mb4(如mysql:host=127.0.0.1;dbname=test;charset=utf8mb4),否则 CLI 下中文可能乱码
执行完记得显式关闭连接,尤其循环调用时
CLI 脚本退出时 PHP 会释放资源,但若脚本长时运行、反复查库(比如定时任务轮询),不关连接会导致 MySQL 的 max_connections 快速耗尽。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- mysqli:调用
mysqli_close($conn),不要依赖脚本结束自动回收 - PDO:设
$pdo = null或直接unset($pdo),比$pdo = null更可靠释放底层连接 - 如果使用连接池或持久连接(
PDO::ATTR_PERSISTENT => true),更要清楚其生命周期 —— CLI 下持久连接不会跨进程复用,反而易引发状态残留
实际跑起来最常卡在第一关:CLI 的 php.ini 没开扩展,或 MySQL 用户没授 localhost(而非 127.0.0.1)权限。先跑通 php -r "var_dump(new PDO('mysql:host=127.0.0.1;dbname=test', 'user', 'pass'));",再写逻辑。











