Laravel中如何实现MySQL布尔查询兼容true/false与0/1参数

我在Laravel中创建了users表，其中is_active字段为布尔类型，默认值为false。查询代码通过请求的is_active参数进行条件过滤：

public function up()
{
    Schema::create('users', function (Blueprint $table) {
        $table->id();
        $table->string('name');
        $table->string('email')->unique();
        $table->string('phone_no')->unique();
        $table->enum('role', ['admin', 'subadmin', 'user'])->index();
        $table->boolean('is_active')->default(false)->index();
        $table->timestamp('email_verified_at')->nullable();
        $table->string('password');
        $table->json('meta')->nullable();
        $table->rememberToken();
        $table->timestamps();
    });
} 

return User::query()
    ->when($request->is_active, fn($query) => $query->where('is_active', $request->is_active))
    ->when($request->role, fn($query) => $query->where('role', $request->role))
    ->orderBy('created_at', 'desc')
    ->get();

当前遇到的问题：

• 当请求参数is_active传false时，能正确过滤出is_active为false的数据；
• 但传true时，仍显示is_active为false的结果，只有传1时才能正确过滤出is_active为true的数据。

需要实现让is_active参数支持true/false或0/1两种形式均可正确过滤。

问题核心在于HTTP请求参数默认是字符串类型，当你传true时，实际拿到的是字符串'true'，而数据库的boolean字段底层是tinyint(1)类型，直接用字符串作为查询条件会导致类型转换异常，无法正确匹配。同时原代码中when($request->is_active)存在逻辑漏洞：如果参数传false或0，when的第一个参数会被判定为false，导致过滤逻辑不执行。

以下是几种可行的解决方式：

方式1：手动转换参数 #

在查询前统一处理is_active参数，将字符串形式的true/false/0/1转为标准布尔值：

$isActive = match(strtolower($request->is_active)) {
    'true', '1' => true,
    'false', '0' => false,
    default => null // 无有效值时返回null，让when条件不生效
};

return User::query()
    ->when($isActive !== null, fn($query) => $query->where('is_active', $isActive))
    ->when($request->role, fn($query) => $query->where('role', $request->role))
    ->orderBy('created_at', 'desc')
    ->get();

方式2：用请求验证自动转换 #

借助Laravel的请求验证规则，自动完成参数类型转换+校验，同时让代码更规范：

1. 创建请求类（比如UserListRequest）：

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class UserListRequest extends FormRequest
{
    public function rules()
    {
        return [
            'is_active' => 'nullable|boolean',
            'role' => 'nullable|in:admin,subadmin,user'
        ];
    }
}

2. 在控制器中使用该请求类：

public function index(UserListRequest $request)
{
    // 验证后$request->is_active已转为标准布尔值（null/true/false）
    return User::query()
        ->when($request->is_active !== null, fn($query) => $query->where('is_active', $request->is_active))
        ->when($request->role, fn($query) => $query->where('role', $request->role))
        ->orderBy('created_at', 'desc')
        ->get();
}

方式3：自定义请求宏（全局复用） #

如果多个业务场景都需要处理这类布尔参数，可以全局注册请求宏，方便复用：

1. 在AppServiceProvider的boot方法中注册宏：

use Illuminate\Http\Request;

public function boot()
{
    Request::macro('boolean', function ($key) {
        $value = $this->input($key);
        return match(strtolower((string)$value)) {
            'true', '1', 'yes' => true,
            'false', '0', 'no' => false,
            default => null
        };
    });
}

2. 在控制器中直接调用：

$isActive = $request->boolean('is_active');

return User::query()
    ->when($isActive !== null, fn($query) => $query->where('is_active', $isActive))
    ->when($request->role, fn($query) => $query->where('role', $request->role))
    ->orderBy('created_at', 'desc')
    ->get();

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