PHP不能直接定义主键，主键必须在数据库层通过SQL（如CREATE TABLE或ALTER TABLE）声明，且要求字段NOT NULL、唯一；PDO/ORM仅执行语句，数据不满足条件则报错。
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 或其他字段作主键，必须手动覆盖：
XDcms是南宁旭东网络科技有限公司推出的一套完全开源的通用的内容管理系统。主要使用php+mysql+smarty技术基础进行开发，XDcms采用OOP(面向对象)方式进行基础运行框架搭建。模块化开发方式做为功能开发形式。框架易于功能扩展，代码维护，二次开发能力优秀。 XDcms重点功能 A、内容管理模型，自定义字段，更方便扩展功能。自带模型：单页模型、新闻模型、产品模型、招聘模型 B、栏目自定
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。
立即学习“PHP免费学习笔记（深入）”；
- 先清理数据：
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，否则错误静默失败
