CakePHP 4如何从数据库表中查询获取去重的年份列表

CakePHP 4 不再支持旧版本中直接在字段配置内写原生SQL片段的写法，直接书写DISTINCT YEAR(date)会被查询构建器作为普通字段名转义，导致生成的SQL语法错误。你可以使用查询构建器的函数构造接口来实现需求，最简实现代码如下：

// 控制器方法内代码
$years = $this->Events->find()
    ->select(function (\Cake\ORM\Query $query) {
        return [
            'year' => $query->func()->year(['date' => 'identifier'])
        ];
    })
    ->distinct('year')
    ->orderBy(['year' => 'DESC'])
    ->all();

$this->set(compact('years'));

如果你需要直接获取一维的年份数组（格式为[2024, 2023, 2022...]），可以直接在查询后追加提取逻辑：

$years = $this->Events->find()
    ->select(function (\Cake\ORM\Query $query) {
        return [
            'year' => $query->func()->year(['date' => 'identifier'])
        ];
    })
    ->distinct('year')
    ->orderBy(['year' => 'DESC'])
    ->extract('year')
    ->toList();

$this->set(compact('years'));

如果需要指定表名避免字段冲突，将date替换为Events.date即可，逻辑和CakePHP 2的实现保持一致。

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