PHP命令行执行SQL查询技巧

本文深入解析了在PHP命令行（CLI）环境下安全、可靠执行MySQL查询的关键要点与常见陷阱，强调CLI环境缺乏Web服务器的自动配置支持，必须显式指定连接参数（如host、port、socket）、严格验证凭据与网络权限、启用对应扩展（mysqli或pdo_mysql），并针对mysqli_query()和PDO::query()分别给出防错、防注入、字符集设置及资源释放的最佳实践，特别提醒开发者注意localhost解析歧义、php.ini配置差异、错误处理缺失、中文乱码和连接泄漏等高频问题，助你快速避坑、稳定运行数据库脚本。

PHP CLI 执行 MySQL 查询前必须确认连接方式

CLI 环境下没有 Web 服务器的自动配置，mysqli 或 PDO 连接失败几乎全是因凭据或网络配置缺失导致。别直接套用 localhost —— 它在 CLI 中可能解析为 127.0.0.1（走 TCP），也可能走 Unix socket，而你的 MySQL 可能只监听 socket 或只允许特定 host。

实操建议：

• 用 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 下无自动错误处理，不加判断就静默失败。

实操建议：

• 必须检查返回值：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，容易漏判。

实操建议：

• 初始化 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 快速耗尽。

实操建议：

• 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'));"，再写逻辑。

到这里，我们也就讲完了《PHP命令行执行SQL查询技巧》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！