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 8.5.5 PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。
下载立即学习“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()
