Laravel为用户表添加依赖name字段的slug列的实现方案

步骤1：创建可空的slug列 #

先添加允许为空的slug字段，避免因无默认值导致迁移失败，同时保留现有数据：

如果还未执行原迁移，直接修改迁移文件；若已执行原迁移，先创建新迁移：php artisan make:migration add_slug_to_users_table

Schema::table('users', function (Blueprint $table) {
    $table->string('slug')->after('name')->nullable();
});

执行迁移：

php artisan migrate

步骤2：批量填充现有用户的slug #

用Laravel Tinker批量为已有用户生成slug（数据量大时用chunk避免内存溢出）：

1. 启动Tinker：

php artisan tinker

2. 执行批量更新代码：

use Illuminate\Support\Str;
use App\Models\User;

User::chunk(100, function ($users) {
    foreach ($users as $user) {
        $user->slug = Str::slug($user->name);
        $user->save();
    }
});

步骤3：（可选）设置slug列为非空 #

如果业务要求slug不可为空，创建新迁移修改列属性：

Schema::table('users', function (Blueprint $table) {
    $table->string('slug')->after('name')->nullable(false)->change();
});

执行迁移：

php artisan migrate

步骤4：自动为新用户生成唯一slug #

在User模型中添加创建事件，确保新用户自动生成slug，同时处理重名导致的slug重复：

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Str;

class User extends Model
{
    // ... 其他模型代码

    protected static function booted()
    {
        static::creating(function ($user) {
            // 生成基础slug
            $baseSlug = Str::slug($user->name);
            $user->slug = $baseSlug;

            // 检查重复，存在则追加数字
            $count = static::whereRaw("slug RLIKE '^{$baseSlug}(-[0-9]+)?$'")->count();
            if ($count > 0) {
                $user->slug .= '-' . ($count + 1);
            }
        });
    }
}

步骤5：更新路由实现slug访问 #

修改用户详情路由，使用slug进行路由模型绑定：

Route::get('/users/{user:slug}', [\App\Http\Controllers\UserController::class, 'show']);

此时访问/users/john-doe，Laravel会自动通过slug查找对应用户，无需修改控制器的show方法。

内容的提问来源于stack exchange，提问作者noah1400