Laravel如何批量创建查询作用域（Scopes）？

当然有办法解决这个批量生成查询作用域的问题！针对你这种需要为50+组织模型自动生成对应slug的查询作用域场景，我们可以利用Laravel的魔术方法和**动态方法扩展（Macro）**来实现，完全不用手动一个个定义scopeXxx方法。

方法一：基于现有Slug列表的严谨实现 #

这个方法会先加载所有组织的slug，只对存在的slug生成对应的查询作用域，避免无效的方法调用：

use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Facades\Cache;

class Organization extends Model
{
    // 存储所有可用的组织slug
    protected static $availableSlugs = [];

    protected static function boot()
    {
        parent::boot();

        // 提前加载并缓存所有slug（避免每次请求重复查询）
        static::$availableSlugs = Cache::rememberForever('organization_slugs', function () {
            return static::pluck('slug')->toArray();
        });
    }

    public static function __callStatic($method, $parameters)
    {
        $scopeMethodName = 'scope' . ucfirst($method);

        // 仅当不存在原生作用域方法，且调用的方法名匹配现有slug时，生成动态作用域
        if (!method_exists(static::class, $scopeMethodName) && in_array($method, static::$availableSlugs)) {
            static::macro($scopeMethodName, function (Builder $query) use ($method) {
                return $query->where('slug', $method);
            });
        }

        // 交给父类处理其他静态方法调用
        return parent::__callStatic($method, $parameters);
    }
}

工作原理： #

1. 在模型的boot方法中，我们提前加载所有组织的slug并缓存起来，避免重复查询数据库。
2. 利用__callStatic魔术方法拦截静态方法调用，判断当前调用的方法名是否对应一个已存在的slug。
3. 如果匹配，就用macro动态生成对应的查询作用域方法，之后你就可以像调用手动定义的作用域一样使用它：

   // 直接调用slug对应的方法
   $microsoftOrg = Organization::microsoft()->first();
   $googleOrg = Organization::google()->first();
   

注意事项： #

• 如果组织的slug经常更新，记得清理缓存（Cache::forget('organization_slugs')），否则新的slug不会生效。
• 不会覆盖模型已有的原生方法或手动定义的作用域，因为我们先判断了method_exists。

方法二：简化实现（允许任意方法名） #

如果你不需要严格校验slug是否存在，只想让所有类似Organization::xxx()的调用自动转为where('slug', 'xxx')的查询，可以用更简单的版本：

use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;

class Organization extends Model
{
    public static function __callStatic($method, $parameters)
    {
        $scopeMethodName = 'scope' . ucfirst($method);

        // 只要没有对应的原生作用域方法，就生成动态作用域
        if (!method_exists(static::class, $scopeMethodName)) {
            static::macro($scopeMethodName, function (Builder $query) use ($method) {
                return $query->where('slug', $method);
            });
        }

        return parent::__callStatic($method, $parameters);
    }
}

特点： #

• 不需要提前加载或缓存slug，实现更简洁。
• 如果调用了不存在的slug（比如Organization::nonexistentOrg()），查询会返回空结果，不会报错。
• 同样支持所有合法的slug调用，完全满足你批量生成作用域的需求。

额外优化：支持驼峰方法名对应蛇形Slug #

如果你的slug是蛇形命名（比如google_cloud），但想通过驼峰方法名调用（Organization::googleCloud()），可以添加字符串转换逻辑：

use Illuminate\Support\Str;

// 在__callStatic方法中替换判断逻辑
$slug = Str::snake($method);
if (!method_exists(static::class, $scopeMethodName) && in_array($slug, static::$availableSlugs)) {
    static::macro($scopeMethodName, function (Builder $query) use ($slug) {
        return $query->where('slug', $slug);
    });
}

这样你就可以用Organization::googleCloud()来查询slug为google_cloud的组织了。

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