PHP定义主键字段方法详解

本文深入剖析了PHP中“定义主键”的常见误区与正确实践，明确指出PHP作为脚本语言本身无法直接定义主键——主键是数据库层面的强制约束，必须通过SQL语句（如CREATE TABLE或ALTER TABLE）在数据库中声明，且要求字段非空、唯一；文章系统讲解了使用PDO原生执行建表/改表语句、Laravel Eloquent迁移文件配置及线上表修改主键的完整流程，同时强调数据清理、错误处理和生产环境风险（如锁表、重复值、NULL值报错等关键细节），帮助开发者避开“在PHP代码里徒劳写PRIMARY KEY”的典型陷阱，真正理解主键生效的本质在于合法SQL与合规数据的双重保障。

PHP中不能直接“定义主键字段”

PHP本身是脚本语言，不负责数据库表结构定义；所谓“定义主键”，实际发生在数据库层（如 MySQL），PHP 只是通过 SQL 语句或 ORM 工具去执行建表或修改操作。混淆这点会导致你试图在 $pdo->query() 之外的地方写 PRIMARY KEY，结果毫无作用。

用 PDO 执行 CREATE TABLE 时声明主键

这是最直接、最可控的方式。主键必须在建表时显式指定，或后续用 ALTER TABLE 添加。常见错误是漏掉 NOT NULL —— MySQL 要求主键列必须非空，否则会报错 ERROR 1171 (42000): All parts of a PRIMARY KEY must be NOT NULL。

CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(50) NOT NULL,
    email VARCHAR(100) UNIQUE
);

• AUTO_INCREMENT 仅适用于整数类型，且一个表只能有一个
• 复合主键写法：PRIMARY KEY (user_id, role_id)
• 主键名可自定义：CONSTRAINT pk_users_id PRIMARY KEY (id)，方便后期 ALTER DROP

用 Laravel Eloquent 迁移文件定义主键

框架封装了语法，但底层仍是生成并执行 SQL。默认 id 字段会被自动设为主键和自增，但如果你改用 UUID 或其他字段作主键，必须手动覆盖：

Schema::create('posts', function (Blueprint $table) {
    $table->uuid('uuid')->primary(); // 替换默认 id
    $table->string('title');
    $table->timestamps();
});

• 调用 ->primary() 才会生成 PRIMARY KEY 约束
• 如果已有字段（如 slug）想设为主键，需先 ->dropPrimary() 再重新指定
• Eloquent 默认假设主键叫 id 且是整型自增；若不匹配，必须在模型里声明：protected $primaryKey = 'uuid'; protected $keyType = 'string'; public $incrementing = false;

用 mysqli 或 PDO 修改已有表的主键

线上表加主键不是简单“定义”，而是 DDL 操作，会锁表（尤其大表）。MySQL 不允许直接 ADD PRIMARY KEY 到含 NULL 值或重复值的列上，会报错 ERROR 1062 (23000): Duplicate entry '...' for key 'PRIMARY' 或 ERROR 1138 (22004): Invalid use of NULL value。

• 先清理数据：DELETE FROM table WHERE id IS NULL OR id = ''，再确保唯一性
• 添加主键语句：ALTER TABLE users ADD PRIMARY KEY (id);
• 若原主键要更换，先删后加：ALTER TABLE users DROP PRIMARY KEY, ADD PRIMARY KEY (uuid);
• PDO 中执行需设置 PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION，否则错误静默失败

主键不是 PHP 的语法糖，它是数据库约束，生效与否只取决于你最终发给数据库的那条 SQL 是否合法、数据是否满足条件。最容易被忽略的是：没检查现有数据就对生产表加主键，一执行就卡住或报错。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP定义主键字段方法详解》文章吧，也可关注golang学习网公众号了解相关技术文章。