Laravel如何做数据库迁移字段注释_Laravel添加列说明文字【方法】-Laravel-PHP中文网

MySQL 8.0+ 支持 migration 中直接用 comment() 添加字段注释，Laravel 9+ 兼容；MySQL 5.7 不支持 ADD COLUMN 带 COMMENT，需分步执行 DB::statement() 修改类型并加注释，且 MODIFY 必须完整声明字段类型。

laravel如何做数据库迁移字段注释_laravel添加列说明文字【方法】

MySQL 8.0+ 直接用 `COMMENT` 参数加字段注释

Laravel 9+ + MySQL 8.0+ 环境下，Schema::table() 或迁移中的 table->string('name')->comment('用户名') 能直接生效，底层会生成带 COMMENT 的 ALTER TABLE ... ADD COLUMN 或 CHANGE COLUMN 语句。

但注意：这个行为依赖数据库驱动和版本。MySQL 5.7 不支持在 ADD COLUMN 时带 COMMENT，强行写会报错 SQLSTATE[42000]: Syntax error or access violation。

只对新增字段有效；修改已有字段注释需单独执行 DB::statement("ALTER TABLE users MODIFY name VARCHAR(255) COMMENT '用户名'")
comment() 方法不支持 SQLite、PostgreSQL（它们用不同机制存注释）
如果迁移中混用 change() 和 comment()，Laravel 会尝试用 MODIFY COLUMN，MySQL 5.7 下可能失败

Laravel 低版本或 MySQL 5.7 怎么安全加注释

别硬扛 comment()，改用原生 SQL 更可控。尤其当项目还在 Laravel 8 或 MySQL 5.7 上跑，注释必须分两步：先加字段，再补注释。

示例迁移文件片段：

public function up(Blueprint $table)
{
    $table->string('phone')->after('email');
    DB::statement("ALTER TABLE users COMMENT = '用户基础信息表'");
    DB::statement("ALTER TABLE users MODIFY phone VARCHAR(20) COMMENT '手机号，含区号'");
}

必须用 DB::statement()，不能用 DB::unprepared()（后者不处理 PDO 预处理占位符，容易出错）
修改字段注释时，MODIFY 必须重复声明完整类型（如 VARCHAR(20)），漏写会导致类型被重置为默认 TEXT
注释内容里不能有单引号，否则 SQL 解析失败；建议统一用双引号包裹字符串

注释写进迁移后，怎么查出来

注释不是 Laravel 模型的一部分，它存在数据库元数据里，PHP 层拿不到。想验证是否成功，得查 information_schema.COLUMNS。

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

开发时快速确认：

SELECT column_name, column_comment 
FROM information_schema.COLUMNS 
WHERE table_name = 'users' AND table_schema = 'your_db_name';

Laravel 的 DB::select() 可以查，但别在生产迁移里自动执行——information_schema 查询在某些云数据库上权限受限
phpMyAdmin / TablePlus 等工具的“结构”页能直接看到 Comment 列，比写 SQL 更快
注释不会出现在 php artisan tinker 中的 DB::getSchemaBuilder()->getColumnListing('users') 结果里