本教程详细介绍了如何在php应用中利用mysql的`insert ignore`语句有效防止数据重复插入。当尝试插入的数据在唯一索引（如主键或唯一键）上已存在时，`insert ignore`将自动跳过该行插入，而非抛出错误或替换现有数据。文章将涵盖`insert ignore`的工作原理、使用前提、php集成示例及相关注意事项，帮助开发者维护数据库的数据完整性。
1. 理解数据重复插入问题
在Web应用开发中，尤其是在处理用户提交数据（如注册、商品录入等）时，经常会遇到需要确保某些字段（如用户名、商品编码）的唯一性。如果直接使用标准的INSERT语句，当尝试插入一个已存在唯一标识的数据时，MySQL数据库会抛出一个“Duplicate entry for key”错误，导致程序中断或需要额外的错误处理逻辑。
例如，如果有一个商品表，其中kode（商品编码）字段被定义为唯一键，当用户尝试插入一个已存在的商品编码时，系统应该阻止这次插入，而不是覆盖旧数据或报错。
2. INSERT IGNORE语句的工作原理
MySQL提供了一个非常便捷的解决方案：INSERT IGNORE语句。与标准的INSERT语句不同，INSERT IGNORE在执行插入操作时，如果遇到会导致PRIMARY KEY或UNIQUE索引冲突的行，它不会抛出错误，而是静默地忽略这些冲突行，继续处理其他行（如果存在）。这意味着，如果尝试插入的数据违反了唯一性约束，该行数据将不会被插入，但整个SQL查询仍会成功完成。
核心特性：
立即学习“PHP免费学习笔记（深入）”；
- 不报错： 遇到唯一性冲突时不会产生SQL错误。
- 不插入： 冲突行的数据不会被添加到表中。
- 不更新： 与ON DUPLICATE KEY UPDATE不同，它不会更新现有数据。
3. 使用INSERT IGNORE的前提：唯一性约束
INSERT IGNORE语句能够发挥作用的关键在于数据库表中必须定义了PRIMARY KEY或UNIQUE索引。只有当存在这些唯一性约束时，MySQL才能识别出“重复”的数据。
示例：创建带有唯一索引的表
假设我们有一个名为products的表，其中kode字段需要保证唯一性。我们可以这样创建表：
CREATE TABLE IF NOT EXISTS `products` (
`id` INT AUTO_INCREMENT PRIMARY KEY,
`kode` VARCHAR(50) UNIQUE NOT NULL COMMENT '商品编码，必须唯一',
`nama` VARCHAR(255) NOT NULL COMMENT '商品名称',
`hargabeli` DECIMAL(10, 2) DEFAULT 0.00 COMMENT '采购价格',
`hargajual` DECIMAL(10, 2) DEFAULT 0.00 COMMENT '销售价格',
`keterangan` TEXT COMMENT '商品描述',
`brand` VARCHAR(100) COMMENT '品牌',
`image_name` VARCHAR(255) COMMENT '图片文件名',
`is_active` TINYINT(1) DEFAULT 1 COMMENT '是否启用',
`tanggal_invoice` DATE COMMENT '发票日期',
-- 其他字段...
-- 确保 kode 字段有 UNIQUE 约束
UNIQUE KEY `idx_kode` (`kode`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;在这个例子中，kode字段被设置为UNIQUE NOT NULL，这意味着每条记录的kode值都必须是唯一的且不能为空。
4. 在PHP中集成INSERT IGNORE
现在，我们将展示如何在PHP代码中结合使用mysqli扩展和INSERT IGNORE语句。
步骤一：数据预处理与连接数据库
首先，从用户输入中获取数据，并使用mysqli_real_escape_string进行转义，以防止SQL注入攻击。
<?php
// 数据库连接配置
$servername = "localhost";
$username = "your_username";
$password = "your_password";
$dbname = "your_database";
$tabeldatabase = "products"; // 假设表名为 products
// 创建数据库连接
$conn = new mysqli($servername, $username, $password, $dbname);
// 检查连接
if ($conn->connect_error) {
die("数据库连接失败: " . $conn->connect_error);
}
// 假设通过POST请求接收数据，并进行安全转义
$kode = isset($_POST["kode"]) ? mysqli_real_escape_string($conn, $_POST["kode"]) : '';
$nama = isset($_POST["nama"]) ? mysqli_real_escape_string($conn, $_POST["nama"]) : '';
$hargabeli = isset($_POST["hargabeli"]) ? mysqli_real_escape_string($conn, $_POST["hargabeli"]) : '0.00';
$hargajual = isset($_POST["hargajual"]) ? mysqli_real_escape_string($conn, $_POST["hargajual"]) : '0.00';
$keterangan = isset($_POST["keterangan"]) ? mysqli_real_escape_string($conn, $_POST["keterangan"]) : '';
$brand = isset($_POST["brand"]) ? mysqli_real_escape_string($conn, $_POST["brand"]) : '';
$image_name = isset($_FILES["image"]["name"]) ? mysqli_real_escape_string($conn, $_FILES["image"]["name"]) : ''; // 假设图片文件名
$is_active = isset($_POST["is_active"]) ? (int)$_POST["is_active"] : 1;
$tanggal_invoice = isset($_POST['tanggal_invoice']) ? date('Y-m-d', strtotime($_POST['tanggal_invoice'])) : NULL;
// ... 其他变量的获取和转义 ...
// 建议使用预处理语句（Prepared Statements）来进一步提高安全性。
?>步骤二：构建并执行INSERT IGNORE查询
将处理后的数据组装成INSERT IGNORE语句。强烈建议在INSERT语句中明确指定列名，这可以提高代码的可读性和健壮性，即使表结构发生变化也不易出错。
<?php
// ... (接上面的PHP代码) ...
// 构建 INSERT IGNORE 语句
// 注意：这里仅使用示例中的部分字段，实际应用中请根据你的表结构填写所有字段
$sql = "INSERT IGNORE INTO `$tabeldatabase`
(`kode`, `nama`, `hargabeli`, `hargajual`, `keterangan`, `brand`, `image_name`, `is_active`, `tanggal_invoice`)
VALUES (
'$kode',
'$nama',
'$hargabeli',
'$hargajual',
'$keterangan',
'$brand',
'$image_name',
'$is_active 
