本文旨在解决php通过mysqli_query函数与mysql交互时，创建数据库和表过程中常见的语法错误。核心问题在于mysqli_query不支持同时执行多条sql语句。教程将详细解释此限制，并提供两种有效解决方案：将sql语句拆分独立执行，或使用mysqli_multi_query函数，并强调在创建表前选择正确数据库的重要性。
理解mysqli_query的局限性与常见错误
在PHP中，开发者常使用mysqli_query函数来执行SQL语句与MySQL数据库进行交互。然而，一个常见的误区是尝试将多条SQL语句（例如CREATE DATABASE和CREATE TABLE）合并成一个字符串，并通过一次mysqli_query调用来执行。这通常会导致“SQL语法错误”（You have an error in your SQL syntax）的提示。
例如，以下代码片段展示了这种常见的错误模式：
<?php
$hostname = 'localhost';
$username = 'root';
$password = '';
$connectDB = mysqli_connect($hostname, $username, $password);
if (!$connectDB) {
die('Connection failed: ' . mysqli_connect_error());
}
$query = 'CREATE DATABASE user_records
CREATE TABLE records_list (
id INT(5) NOT NULL PRIMARY KEY AUTO_INCREMENT,
username VARCHAR(30) NOT NULL UNIQUE,
userpass VARCHAR(30) NOT NULL)';
if (mysqli_query($connectDB, $query)) {
echo '<div class="alertSuccess"><span>Query successful</span></div>';
} else {
echo '<div class="alertError"><span>Query failed: <i>' . mysqli_error($connectDB) . '</i></span></div>';
}
mysqli_close($connectDB);
?>当执行上述代码时，MySQL服务器会返回一个语法错误，因为它无法将CREATE DATABASE和紧随其后的CREATE TABLE视为一条合法的SQL语句。mysqli_query函数通常设计为一次只处理一个SQL语句。即使在两条语句之间添加分号，mysqli_query也无法正确解析和执行。
解决方案一：分步执行SQL语句
最直接且推荐的解决方案是将每条SQL语句独立地传递给mysqli_query函数执行。这确保了每条语句都能被MySQL服务器正确解析和处理。
立即学习“PHP免费学习笔记（深入）”；
执行步骤：
- 连接到MySQL服务器：首先建立与MySQL服务器的连接。
- 创建数据库：执行CREATE DATABASE语句。
- 选择数据库：在创建表之前，必须明确指定要在哪个数据库中创建表。可以通过USE database_name;语句或在建立连接时指定数据库。
- 创建表：在新选择的数据库中执行CREATE TABLE语句。
以下是修正后的PHP代码示例：
<?php
$hostname = 'localhost';
$username = 'root';
$password = '';
$database = 'user_records'; // 定义数据库名称
// 1. 连接到MySQL服务器
$connectDB = mysqli_connect($hostname, $username, $password);
if (!$connectDB) {
die('Connection failed: ' . mysqli_connect_error());
}
// 2. 创建数据库（使用 IF NOT EXISTS 确保幂等性）
$queryCrDB = "CREATE DATABASE IF NOT EXISTS " . $database . ";";
if (mysqli_query($connectDB, $queryCrDB)) {
echo '<div class="alertSuccess"><span>数据库 ' . $database . ' 创建成功或已存在</span></div>';
} else {
echo '<div class="alertError"><span>创建数据库失败: <i>' . mysqli_error($connectDB) . '</i></span></div>';
mysqli_close($connectDB);
exit(); // 数据库创建失败，停止执行
}
// 3. 选择数据库
// 方法一：通过 USE 语句
$queryUseDB = "USE " . $database . ";";
if (mysqli_query($connectDB, $queryUseDB)) {
echo '<div class="alertSuccess"><span>已切换到数据库 ' . $database . '</span></div>';
} else {
echo '<div class="alertError"><span>切换数据库失败: <i>' . mysqli_error($connectDB) . '</i></span></div>';
mysqli_close($connectDB);
exit(); // 切换数据库失败，停止执行
}
// 4. 创建表（使用 IF NOT EXISTS 确保幂等性）
$queryCrTb = "CREATE TABLE IF NOT EXISTS records_list (
id INT(5) NOT NULL PRIMARY KEY AUTO_INCREMENT,
username VARCHAR(30) NOT NULL UNIQUE,
userpass VARCHAR(30) NOT NULL
);";
if (mysqli_query($connectDB, $queryCrTb)) {
echo '<div class="alertSuccess"><span>表 records_list 创建成功或已存在</span></div>';
} else {
echo '<div class="alertError"><span>创建表失败: <i>' . mysqli_error($connectDB) . '</i></span></div>';
}
// 关闭数据库连接
mysqli_close($connectDB);
?>注意事项：
- 在创建数据库和表时，使用IF NOT EXISTS子句可以防止在目标数据库或表已存在时引发错误，提高脚本的健壮性。
- 每次mysqli_query调用后都应检查其返回值，以便及时发现并处理错误。
解决方案二：使用mysqli_multi_query处理多语句
如果确实需要在一个函数调用中执行多条SQL语句，PHP提供了mysqli_multi_query函数。这个函数专门设计用于处理包含由分号分隔的多个SQL语句的字符串。
使用mysqli_multi_query的注意事项：
- 结果处理：mysqli_multi_query执行后，需要通过mysqli_next_result()和mysqli_store_result()循环处理每个查询的结果集。如果只是执行DDL（数据定义语言）语句，可能不需要详细处理结果集，但仍需确保所有语句都已执行完毕。
- 安全性：mysqli_multi_query在处理用户输入时更容易受到SQL注入攻击。对于本教程中创建数据库和表的固定操作，风险较低，但对于其他场景，应优先考虑预处理语句。
以下是使用mysqli_multi_query的示例：
<?php
$hostname = 'localhost';
$username = 'root';
$password = '';
$database = 'user_records';
$connectDB = mysqli_connect($hostname, $username, $password);
if (!$connectDB) {
die('Connection failed: ' . mysqli_connect_error());
}
// 组合多条SQL语句，用分号分隔
$multi_query = "
CREATE DATABASE IF NOT EXISTS " . $database . ";
USE " . $database . ";
CREATE TABLE IF NOT EXISTS records_list (
id INT(5) NOT NULL PRIMARY KEY AUTO_INCREMENT,
username VARCHAR(30) NOT NULL UNIQUE,
userpass VARCHAR(30) NOT NULL
);";
if (mysqli_multi_query($connectDB, $multi_query)) {
echo '<div class="alertSuccess"><span>多语句查询执行成功</span></div>';
// 循环处理每个查询的结果集（对于DDL语句，可能不需要详细处理，但仍需遍历）
do {
if ($result = mysqli_store_result($connectDB)) {
// 如果有结果集（如SELECT语句），可以在此处处理
mysqli_free_result($result);
}
} while (mysqli_more_results($connectDB) && mysqli_next_result($connectDB));
// 检查是否有任何后续错误
if (mysqli_error($connectDB)) {
echo '<div class="alertError"><span>部分查询失败: <i>' . mysqli_error($connectDB) . '</i></span></div>';
}
} else {
echo '<div class="alertError"><span>多语句查询执行失败: <i>' . mysqli_error($connectDB) . '</i></span></div>';
}
mysqli_close($connectDB);
?>总结
在PHP中使用mysqli扩展与MySQL交互时，理解mysqli_query和mysqli_multi_query的区别至关重要。mysqli_query通常只支持单条SQL语句，而尝试执行多条语句会导致语法错误。解决此问题的两种主要方法是：
- 分步执行：将复杂的数据库操作分解为独立的SQL语句，并逐一通过mysqli_query执行。这是最安全、最清晰且推荐的做法。
- 使用mysqli_multi_query：当确实需要一次性执行多条语句时，可以使用mysqli_multi_query，但需注意其结果处理机制和潜在的安全风险。
无论选择哪种方法，始终进行彻底的错误检查，并采取防御性编程措施（如使用IF NOT EXISTS、mysqli_real_escape_string或预处理语句）来确保数据库操作的稳定性和安全性。
