CakePHP 4中为特定表扩展VisibilityBehavior的查询条件方案

这里有几种不用复制整个findVisible方法就能实现需求的方式，按实用性排序：

方法1：直接调用行为中的原方法 #

因为行为是挂载到表实例上的，你可以直接通过行为的别名调用它的findVisible方法（之前用parent::会报错，是因为表的父类Table根本没有这个方法）。修改SomeTable的代码如下：

<?php

namespace App\Model\Table;

use Cake\ORM\Query;
use Cake\ORM\Table;

class SomeTable extends Table
{
    public function initialize(array $config): void
    {
        parent::initialize($config);
        $this->addBehavior('Visibility');
    }

    public function findVisible(Query $query, array $options)
    {
        // 先调用行为里的原方法，应用基础可见性条件
        $query = $this->Visibility->findVisible($query, $options);
        // 添加当前表专属的额外条件
        $query->andWhere([$this->aliasField('is_archived') => 0]);

        return $query;
    }
}

这个方法最直接，完全匹配你的需求，不需要修改行为的代码，只在特定表中重写finder并调用行为的对应方法即可。

方法2：给行为添加可配置的自定义条件 #

如果之后还有其他表需要添加不同的额外条件，可以修改VisibilityBehavior，让它支持通过配置传入自定义条件，扩展性更强：

第一步：修改VisibilityBehavior #

<?php

namespace App\Model\Behavior;

use Cake\ORM\Behavior;
use Cake\ORM\Query;

class VisibilityBehavior extends Behavior
{
    protected $_defaultConfig = [
        'implementedFinders' => [
            'visible' => 'findVisible',
        ],
        // 默认空的自定义条件
        'customConditions' => [],
    ];

    public function findVisible(Query $query, array $options)
    {
        // 先添加基础的可见性逻辑条件
        $query->where([
            // 你的基础可见性判断条件
        ]);

        // 如果有配置的自定义条件，合并到查询中
        $customConditions = $this->getConfig('customConditions');
        if (!empty($customConditions)) {
            $query->andWhere($customConditions);
        }

        return $query;
    }
}

第二步：在SomeTable中配置行为 #

<?php

namespace App\Model\Table;

use Cake\ORM\Table;

class SomeTable extends Table
{
    public function initialize(array $config): void
    {
        parent::initialize($config);
        // 添加行为时传入当前表的自定义条件
        $this->addBehavior('Visibility', [
            'customConditions' => [
                $this->aliasField('is_archived') => 0,
            ],
        ]);
    }
}

这种方式不需要在表中重写findVisible方法，直接通过配置就能实现，适合多个表需要不同自定义条件的场景。

方法3：利用事件监听扩展 #

你也可以通过CakePHP的事件系统，在SomeTable中监听Model.beforeFind事件，当触发visible finder时自动添加额外条件：

<?php

namespace App\Model\Table;

use Cake\Event\EventInterface;
use Cake\ORM\Query;
use Cake\ORM\Table;

class SomeTable extends Table
{
    public function initialize(array $config): void
    {
        parent::initialize($config);
        $this->addBehavior('Visibility');
        // 注册事件监听器
        $this->getEventManager()->on('Model.beforeFind', [$this, 'beforeFindVisible']);
    }

    public function beforeFindVisible(EventInterface $event, Query $query, array $options)
    {
        // 只针对visible finder添加额外条件
        if (isset($options['finder']) && $options['finder'] === 'visible') {
            $query->andWhere([$this->aliasField('is_archived') => 0]);
        }
    }
}

这种方式适合需要在多个finder中共享逻辑的场景，但相对前两种稍显繁琐。

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