MySQL多语句执行与数据库选择技巧

本教程旨在解决PHP通过mysqli创建MySQL数据库和表时常见的语法错误。主要探讨了在单个`mysqli_query`中执行多条SQL语句的限制，以及在创建表前未明确选择数据库的问题。文章将提供正确的SQL语句分隔方法和PHP实现，确保数据库和表的顺利创建，并避免“You have an error in your SQL syntax”错误，提升开发效率。

在开发基于PHP和MySQL的应用程序时，创建数据库和数据表是常见的初始化步骤。然而，许多开发者在尝试通过PHP脚本执行SQL语句来同时创建数据库和表时，会遇到“You have an error in your SQL syntax”错误。这通常是由于对MySQL客户端库（如mysqli）的执行机制理解不足，以及对SQL语句执行顺序和上下文的忽视所致。

MySQL语法错误核心原因分析

当尝试在一个mysqli_query()调用中同时执行CREATE DATABASE和CREATE TABLE语句时，主要会遇到以下两个问题：

1. mysqli_query()的单语句限制： mysqli_query()函数默认只执行SQL字符串中的第一条SQL语句。如果字符串中包含多条以分号分隔的SQL语句，mysqli_query()只会处理第一条，而忽略后续的语句，或者在某些情况下直接报错。对于需要执行多条SQL语句的场景，应使用mysqli_multi_query()函数，但即便如此，对于数据库和表的创建，分步执行通常是更清晰和可控的选择。
2. 未选择数据库上下文： CREATE TABLE语句必须在一个特定的数据库上下文中执行。这意味着在执行CREATE TABLE之前，必须明确地告诉MySQL服务器要在哪个数据库中创建这张表。如果在CREATE DATABASE之后没有显式地选择该数据库，CREATE TABLE语句将无法找到其所属的数据库，从而导致语法错误。

正确的SQL语句执行策略

为了避免上述问题，创建数据库和表的操作应遵循以下策略：

1. 分离SQL语句： 将CREATE DATABASE和CREATE TABLE语句作为独立的SQL命令处理。
2. 明确选择数据库： 在执行CREATE TABLE语句之前，使用USE database_name;命令或PHP的mysqli_select_db()函数来指定当前操作的数据库。

PHP与MySQL创建数据库和表的示例

以下是一个通过PHP mysqli扩展正确创建数据库和数据表的完整示例。此示例将演示如何分步执行SQL语句，并在创建表之前选择目标数据库。

<?php
// 数据库连接参数
$hostname = 'localhost';
$username = 'root';
$password = '';
$database_name = 'user_records';
$table_name = 'records_list';

// 1. 连接MySQL服务器 (不指定数据库，因为要先创建数据库)
$connectDB = mysqli_connect($hostname, $username, $password);
if (!$connectDB) {
    die('数据库连接失败: ' . mysqli_connect_error());
}

echo '<p>数据库连接成功。</p>';

// 2. 创建数据库
// 使用 IF NOT EXISTS 避免重复创建时报错
$queryCrDB = "CREATE DATABASE IF NOT EXISTS " . $database_name . ";";
if (mysqli_query($connectDB, $queryCrDB)) {
    echo '<p class="alertSuccess">数据库 "' . $database_name . '" 创建成功或已存在。</p>';
} else {
    echo '<p class="alertError">数据库创建失败: <i>' . mysqli_error($connectDB) . '</i></p>';
    mysqli_close($connectDB);
    exit(); // 数据库创建失败，后续操作无意义，直接退出
}

// 3. 选择新创建的数据库
// 这一步至关重要，确保后续的 CREATE TABLE 语句在正确的数据库中执行
if (mysqli_select_db($connectDB, $database_name)) {
    echo '<p>已成功选择数据库 "' . $database_name . '"。</p>';
} else {
    echo '<p class="alertError">选择数据库 "' . $database_name . '" 失败: <i>' . mysqli_error($connectDB) . '</i></p>';
    mysqli_close($connectDB);
    exit(); // 选择数据库失败，后续操作无意义，直接退出
}

// 4. 创建数据表
// 使用 IF NOT EXISTS 避免重复创建时报错
$queryCrTb = "CREATE TABLE IF NOT EXISTS " . $table_name . " (
    id INT(11) NOT NULL PRIMARY KEY AUTO_INCREMENT,
    username VARCHAR(30) NOT NULL UNIQUE,
    userpass VARCHAR(255) NOT NULL
);"; // 注意：INT(5) 在现代MySQL中仅为显示宽度提示，实际存储范围不变；VARCHAR(255) 更安全

if (mysqli_query($connectDB, $queryCrTb)) {
    echo '<p class="alertSuccess">数据表 "' . $table_name . '" 创建成功或已存在。</p>';
} else {
    echo '<p class="alertError">数据表创建失败: <i>' . mysqli_error($connectDB) . '</i></p>';
}

// 5. 关闭数据库连接
mysqli_close($connectDB);
echo '<p>数据库连接已关闭。</p>';
?>

<style>
.alertSuccess { color: green; font-weight: bold; }
.alertError { color: red; font-weight: bold; }
</style>

代码说明：

• 分步执行： CREATE DATABASE和CREATE TABLE语句分别通过独立的mysqli_query()调用执行。
• mysqli_select_db()： 在创建表之前，使用mysqli_select_db($connectDB, $database_name)明确指定要操作的数据库。这是解决“未选择数据库”问题的关键。
• 错误处理： 每个mysqli_query()调用后都检查其返回值，并根据结果输出成功或失败信息，这对于调试和用户反馈至关重要。
• IF NOT EXISTS： 在CREATE DATABASE和CREATE TABLE语句中加入IF NOT EXISTS子句，可以使脚本具有幂等性，即多次运行不会因为数据库或表已存在而报错。

注意事项

1. 错误处理： 任何数据库操作都应包含健壮的错误处理机制。mysqli_error()和mysqli_connect_error()函数提供了详细的错误信息，有助于快速定位问题。
2. 安全性： 在生产环境中，数据库的用户名、密码等敏感信息不应直接硬编码在脚本中，而应通过配置文件、环境变量或安全的密钥管理系统进行管理。此外，对于用户密码等敏感数据，应使用更安全的哈希算法（如password_hash()）存储，而不是明文或简单的VARCHAR(30)。示例中已将userpass字段的长度增加到VARCHAR(255)以适应哈希存储。
3. 数据类型与长度： INT(5)中的5在MySQL 8.0及更高版本中，主要作为显示宽度提示，并不会限制整数的实际存储范围。对于密码字段，VARCHAR(30)可能不足以存储加密后的哈希值，建议使用VARCHAR(255)甚至TEXT类型。
4. 资源管理： 在脚本执行完毕或不再需要数据库连接时，应使用mysqli_close()及时关闭连接，释放资源。
5. mysqli_multi_query()： 虽然mysqli_multi_query()可以执行多条SQL语句，但它的使用相对复杂，需要额外的循环来处理结果集。对于简单的数据库和表创建任务，分步执行mysqli_query()通常是更清晰和易于维护的方案。

总结

解决MySQL创建数据库和表时的语法错误，关键在于理解mysqli_query()的单语句执行特性以及CREATE TABLE操作对数据库上下文的依赖。通过将CREATE DATABASE和CREATE TABLE操作分离，并在创建表之前明确选择目标数据库，可以有效地避免常见的语法错误。同时，遵循良好的编程实践，如错误处理、安全性考量和资源管理，将有助于构建更稳定、可靠的PHP与MySQL应用。