CakePHP3中如何实现表单向控制器传递多个搜索参数

看起来你想要实现一个用户搜索功能，要么是传递姓名和邮箱两个独立参数，要么是用一个关键词同时匹配这两个字段。我帮你梳理两种场景的正确实现方式，同时修正你当前代码里的小问题：

场景1：让用户分别输入姓名和邮箱（传递两个独立参数） #

如果希望用户可以分别填写姓名和邮箱来筛选，你需要先修改表单，添加两个输入控件：

<?= $this->Form->create("", ['type'=>'get']) ?>
    <?= $this->Form->control('first_name', ['label' => '姓名']); ?>
    <?= $this->Form->control('email', ['label' => '邮箱']); ?>
    <button type="submit">搜索</button>
<?= $this->Form->end() ?>

然后在控制器里接收这两个参数，用查询构建器构建灵活的筛选条件：

// 获取表单提交的查询参数
$firstName = $this->request->query('first_name');
$email = $this->request->query('email');

// 初始化查询
$query = $this->Users->find();

// 姓名筛选（如果用户填写了姓名）
if (!empty($firstName)) {
    $query->where(['first_name LIKE' => "%{$firstName}%"]);
}

// 邮箱筛选（如果用户填写了邮箱）
if (!empty($email)) {
    // 如果你想让两个条件是「AND」关系（同时满足），直接用where；如果是「OR」关系，改成orWhere
    $query->where(['email LIKE' => "%{$email}%"]);
}

// 获取结果
$users = $query->all();

场景2：单关键词同时匹配姓名或邮箱（你的原始需求） #

你当前用的findAllByFirst_nameOrEmail是CakePHP的动态查找器，但它的用法不符合你的需求——这个方法需要传递两个参数（分别对应姓名和邮箱的精确值），而你想要的是一个关键词模糊匹配两个字段。

推荐用官方更推荐的查询构建器来实现，表单可以保持原样，控制器代码修改如下：

$keyword = $this->request->query('keyword');
$users = [];

// 只有当关键词不为空时才执行查询
if (!empty($keyword)) {
    $users = $this->Users->find()
        ->where(function ($exp) use ($keyword) {
            // 创建OR条件：匹配姓名 或者 邮箱
            return $exp->or_([
                'first_name LIKE' => "%{$keyword}%",
                'email LIKE' => "%{$keyword}%"
            ]);
        })
        ->all();
}

额外提醒：防止SQL注入 #

上面的写法虽然能工作，但为了更安全，建议使用参数绑定来避免SQL注入风险：

$users = $this->Users->find()
    ->where(function ($exp) use ($keyword) {
        return $exp->or_(['first_name LIKE' => ':keyword'])
                   ->or_(['email LIKE' => ':keyword'])
                   ->bind(':keyword', "%{$keyword}%", 'string');
    })
    ->all();

另外补充一点：CakePHP 3中动态查找器（比如findAllBy*）已经属于不推荐的用法了，查询构建器不仅更灵活，可读性和可维护性也更高，建议以后都用这种方式来写查询逻辑。

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