本文旨在解决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或预处理语句）来确保数据库操作的稳定性和安全性。