Eloquent-Sluggable 实现条件性唯一Slug的最佳实践

Eloquent-Sluggable 是一个流行的 Laravel 扩展包，用于为模型生成 URL 友好的 slug。在实际开发中，我们经常需要根据业务需求对 slug 的唯一性进行条件限制。本文将深入探讨如何实现基于父级ID的条件性唯一 slug 验证。

场景分析

在文档管理系统开发中，常见的需求是：

• 文档可以有多个层级（如文档集和文档页）
• 同一父级下的 slug 需要保持唯一
• 不同父级下的 slug 可以重复

例如：

文档集A (slug: docs-a)
  - 页面1 (slug: page)
  - 页面2 (slug: page-2)

文档集B (slug: docs-b)
  - 页面1 (slug: page)  // 允许与文档集A中的页面1重复
  - 页面2 (slug: page-2)

解决方案

Eloquent-Sluggable 提供了 scopeWithUniqueSlugConstraints 方法来实现条件性唯一验证。我们可以通过重写这个方法来实现基于父级ID的约束。

基础实现

public function scopeWithUniqueSlugConstraints($query)
{
    return $query->where('parent_id', $this->parent_id);
}

这个简单的实现确保了：

1. 同一父级下的 slug 必须唯一
2. 不同父级下的 slug 可以重复
3. 自动处理 slug 冲突时的序号追加（如 page, page-2, page-3）

高级场景处理

对于更复杂的场景，比如顶级文档（parent_id=0）需要特殊处理，可以这样实现：

public function scopeWithUniqueSlugConstraints($query)
{
    if ($this->parent_id == 0) {
        return $query->where('parent_id', 0);
    }
    return $query->where('parent_id', $this->parent_id);
}

最佳实践建议

1. 索引优化：确保数据库中对 parent_id 和 slug 字段建立了复合索引，提高查询效率

2. 模型关系：考虑使用 Eloquent 的关系方法（如 belongsTo 和 hasMany）来管理层级关系

3. 缓存策略：对于频繁访问的文档，考虑缓存生成的 slug 路径

4. 批量处理：在导入大量数据时，可以临时禁用 slug 生成，最后统一处理

5. 多租户支持：如果需要支持多租户，可以在唯一性约束中加入租户ID

通过合理使用 Eloquent-Sluggable 的条件性唯一约束功能，开发者可以轻松构建灵活、高效的文档管理系统，满足各种复杂的业务需求。