PHP命令行创建数据库步骤详解

本文详解如何在PHP命令行（CLI）环境下安全高效地创建MySQL/MariaDB数据库，强调PHP本身无内置建库函数，必须借助mysqli或PDO扩展执行SQL语句；重点说明了服务连通性、用户CREATE权限、库名用反引号包裹及强制指定utf8mb4字符集等关键实践要点，并提供了可直接运行的极简mysqli脚本示例，为自动化部署和开发环境初始化提供可靠、轻量的解决方案。

能，但 PHP 本身不直接提供 CREATE DATABASE 的内置函数，必须通过数据库扩展（如 mysqli 或 PDO）连接 MySQL/MariaDB 服务后执行 SQL 语句——这意味着 CLI 下运行的前提是：PHP 能连上数据库服务，且当前用户有 CREATE 权限。

CLI 下用 mysqli 建库最简可行写法

直接调用 mysqli 扩展是最轻量、无依赖的方式，适合脚本化建库：

#!/usr/bin/env php
<?php
$host = '127.0.0.1';
$user = 'root';
$pass = 'your_password'; // 生产环境避免硬编码密码

$mysqli = new mysqli($host, $user, $pass);
if ($mysqli->connect_error) {
    die("连接失败: " . $mysqli->connect_error);
}

$db_name = 'myapp_dev';
if ($mysqli->query("CREATE DATABASE IF NOT EXISTS `$db_name` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci")) {
    echo "数据库 '$db_name' 创建成功\n";
} else {
    echo "建库失败: " . $mysqli->error . "\n";
}
$mysqli->close();

• mysqli 默认不启用持久连接，CLI 脚本执行完即释放连接，安全干净
• 务必用反引号包裹 $db_name，防止库名含特殊字符或关键字时报错
• IF NOT EXISTS 是关键，避免重复运行脚本报错退出
• 字符集显式指定 utf8mb4，否则默认可能是 latin1，后续存 emoji 或中文易出问题

PDO 方式更灵活但需注意 DSN 写法

如果项目已用 PDO，或需要统一错误处理风格，可用 PDO，但注意：PDO 构造时不能指定数据库名（建库前不存在），DSN 中只写 host 和 port：

$dsn = 'mysql:host=127.0.0.1;port=3306';
$pdo = new PDO($dsn, $user, $pass, [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
]);
$pdo->exec("CREATE DATABASE IF NOT EXISTS `myapp_test` CHARACTER SET utf8mb4");

• DSN 里写 dbname=myapp_test 会报错，因为库还不存在
• PDO::ATTR_ERRMODE 设为 EXCEPTION 才能捕获建库失败异常，否则静默失败
• 不推荐在 CLI 脚本里用 PDO::ATTR_PERSISTENT => true，CLI 没连接池概念，反而可能残留连接

常见失败原因和绕过方法

运行时提示 Access denied for user 或 Can't connect to MySQL server 是高频问题：

• MySQL 服务没启动：sudo systemctl status mysql 确认状态，sudo systemctl start mysql 启动
• PHP CLI 使用的 php.ini 和 Web 版不同，检查是否启用了 extension=mysqli 或 extension=pdo_mysql
• root 用户被限制只能从 localhost 连接，而 CLI 中 127.0.0.1 触发的是 TCP 连接，需确认权限：SELECT host FROM mysql.user WHERE User='root';
• 密码含特殊字符（如 $、@）未转义，导致 shell 解析错误——把密码用单引号包严，或改用配置文件读取

建库操作本身很简单，真正卡住的几乎全是环境连通性与权限配置；别在 SQL 语法上花时间调试，先确保 mysql -u root -p -h 127.0.0.1 能手动登录成功，再跑 PHP 脚本。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。