CakePHP 中使用 find() 限制 hasMany 查询字段的方法

本文介绍了在 Cakephp 中使用 find() 方法查询关联表数据时，如何有效地限制主表和关联表的字段，以优化性能。文章详细讲解了在 hasMany 关联关系中，由于数据合并发生在 PHP 层，主表主键的重要性，并提供了使用 formatResults() 方法在查询后过滤字段的实用技巧。

在使用 CakePHP 进行数据库查询时，经常需要使用 contain() 方法来获取关联表的数据。但是，默认情况下，CakePHP 会返回所有字段，这在数据量大的情况下会影响性能。本文将介绍如何在使用 find() 方法和 contain() 方法时，限制主表和关联表的字段，从而提高查询效率。

限制关联表字段

在使用 contain() 方法时，可以通过回调函数来限制关联表的字段。回调函数接收一个查询对象作为参数，可以使用 select() 方法来指定需要查询的字段。

以下是一个示例，假设 ProcessoAdministrativo 表与 DocumentoProcessoAdministrativo 表之间存在 hasMany 关联关系，我们只想查询 ProcessoAdministrativo 表的 codigo_pa 字段，以及 DocumentoProcessoAdministrativo 表的 id、descricao、ordem 和 processo_administrativo_id 字段：

立即学习“PHP免费学习笔记（深入）”；

<?php  use CakeORMTableRegistry;  $tablePA = TableRegistry::get('ProcessoAdministrativo');  $query = $tablePA->find()     ->select(['id', 'codigo_pa']) // 必须包含主键 'id'     ->contain([         'DocumentoProcessoAdministrativo' => function ($q) {             return $q->select(['id', 'descricao', 'ordem', 'processo_administrativo_id']);         }     ]);  $results = $query->toArray();  debug($results);  ?>

注意： 在使用 contain() 方法限制关联表字段时，必须包含主表的主键。这是因为 CakePHP 在 PHP 层合并 hasMany 或 belongsToMany 关系的数据时，需要使用主键来关联记录。如果没有主键，ORM 无法确定哪个 DocumentoProcessoAdministrativo 记录属于哪个 ProcessoAdministrativo 记录。

移除主表不需要的字段

即使限制了查询字段，主表的主键仍然会被包含在结果中。如果不需要主表的主键，可以使用 formatResults() 方法在查询后将其移除。

formatResults() 方法接收一个回调函数作为参数，该回调函数接收一个 CakeCollectionCollectionInterface 对象，该对象包含查询结果。可以在回调函数中使用 map() 方法来遍历结果集，并使用 unset() 方法移除不需要的字段。

以下是一个示例，移除 ProcessoAdministrativo 表的 id 字段：

<?php  use CakeORMTableRegistry;  $tablePA = TableRegistry::get('ProcessoAdministrativo');  $query = $tablePA->find()     ->select(['id', 'codigo_pa']) // 必须包含主键 'id'     ->contain([         'DocumentoProcessoAdministrativo' => function ($q) {             return $q->select(['id', 'descricao', 'ordem', 'processo_administrativo_id']);         }     ])     ->formatResults(function (CakeCollectionCollectionInterface $results) {         return $results->map(function ($row) {             unset($row['id']);             return $row;         });     });  $results = $query->toArray();  debug($results);  ?>

总结

通过使用 select() 方法和 formatResults() 方法，可以有效地限制 CakePHP 查询结果中的字段，从而提高查询效率和减少内存占用。在限制字段时，请务必记住包含主表的主键，并根据需要使用 formatResults() 方法移除不需要的字段。