PHP CLI 连接数据库与 Web 环境本质相同，但需注意配置隔离（CLI 使用独立 php.ini）、凭据安全传递（推荐环境变量或 .env）、连接需手动释放与超时重连、调试依赖终端输出和日志。
PHP 在 CLI 模式下连接数据库和 Web 环境本质相同，但需注意环境差异带来的配置、权限和行为变化。
配置文件与环境隔离
CLI 默认不读取 Apache/Nginx 的 PHP 配置（如 .htaccess 或虚拟主机中的 php_admin_value），而是使用独立的 php.ini 文件。可通过 php --ini 查看 CLI 实际加载的配置路径。常见问题包括：
- 扩展未启用：确保 pdo_mysql、mysqli 或对应驱动在 CLI 的 php.ini 中已开启（extension=pdo_mysql.so）
- 时区未设置：CLI 下 date.timezone 若为空，部分 ORM 或框架会报错，建议显式配置
- 内存限制较低：CLI 默认 memory_limit 可能为 128M 或 -1（无限制），批量操作前应确认是否足够
数据库凭据安全传递
CLI 脚本常用于定时任务或部署脚本，不宜硬编码账号密码。推荐方式：
- 通过环境变量传入：DB_HOST=localhost DB_USER=app DB_PASS=secret php migrate.php，脚本中用 $_ENV['DB_HOST'] 或 getenv('DB_HOST') 读取
- 使用独立配置文件（如 config/cli_db.php），并确保该文件不在 Web 可访问目录下
- 借助 dotenv 库（如 vlucas/phpdotenv）加载 .env 文件，适用于 Laravel/Symfony 等框架的 CLI 命令
连接行为与超时控制
CLI 模式下无请求生命周期管理，连接不会自动释放，需主动处理：
立即学习“PHP免费学习笔记（深入）”；
- 避免长连接泄漏：执行完查询后调用 $pdo = null 或 $mysqli->close() 显式关闭
- 设置合理超时：PDO 构造时添加 PDO::ATTR_TIMEOUT；MySQLi 可设 mysqli_options($link, MYSQLI_OPT_CONNECT_TIMEOUT, 5)
- 重连逻辑更关键：CLI 脚本可能运行数小时，网络波动易导致连接断开，建议封装带重试的查询方法，或使用 PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION 捕获 PDOException 后重连
调试与日志建议
CLI 没有浏览器输出，调试需依赖终端和日志：
- 启用错误报告：error_reporting(E_ALL); ini_set('display_errors', 'stderr'); 确保错误输出到终端而非被静默丢弃
- 记录 SQL 执行情况：对关键操作写入日志文件（如用 file_put_contents('cli.log', date('Y-m-d H:i:s') . " $sql\n", FILE_APPEND)）
- 避免依赖 session 或 cookie 相关功能：CLI 下 session_start() 会失败，也不支持 setcookie()
