绝大多数场景用find()，它自动处理类型转换、关联加载、参数绑定和实体映射；query()仅适用于union all或跨库join等find()无法表达的极少数情况。
CakePHP 5.x 默认已基于 PHP 8.0+ 构建，无需“升级 ORM”本身，但你必须确认实际使用的查询方式是否符合 5.x 规范——否则看似能跑，实则绕过安全机制、漏加载关联、甚至埋下 SQL 注入隐患。
find() 和 query() 到底该用哪个？
绝大多数业务逻辑直接用 find()，不是因为它“简单”，而是它自动处理：字段类型转换、关联 eager loading、参数绑定、实体映射。手写原生 SQL 的 query() 只在两种场景必要：需要 UNION ALL、或跨库 JOIN（CakePHP 原生不支持）。
常见错误是把 query() 当“更高级”用，结果自己拼字符串进 where()，比如：->where("status = '$input'")——这完全跳过参数绑定，等于裸奔。
正确做法始终是：->where(['status' => $input]) 或闭包表达式：->where(function ($exp) use ($input) { return $exp->eq('status', $input); })。
contain() 不出数据？先查这三处
90% 的空关联不是 ORM bug，而是配置断点：
• 关联名写错：比如模型里定义的是 $this->belongsTo('Authors')，但查询时写了 ->contain('Author')（少个 s）；
• 外键字段缺失：articles.author_id 在数据库里不存在，或类型不匹配（如 author_id 是 VARCHAR，但关联目标表主键是 INT）；
• 没显式启用 eager loading：find('all') 默认不加载关联，必须链式调用 ->contain('Authors')，且不能写在 ->all() 之后。
WHERE 条件传数组还是用 where()？
CakePHP 5.x 已彻底弃用数组语法的条件合并（如 ['OR' => [...]]），必须用 where() 配合闭包或表达式对象。
简单等值：->where(['deleted' => false])；
带运算符：->where(['created >= ' => '2024-01-01'])；
OR 组合：->where(function ($exp) { return $exp->or_(['type' => 'A', 'type' => 'B']); })；
NULL 判断：->where(['deleted IS NULL'])（注意不能写成 ['deleted' => null]，那会被解释为 = NULL，永远返回空）。
PHP 8.0+ 特性没生效？检查构造函数和类型声明
CakePHP 5.x 兼容 PHP 8.0+，但你的自定义实体或表类若仍用 PHP 7 风格写法，就浪费了类型安全：
• 实体类别再手动声明属性再赋值，改用构造器属性提升：class Article extends Entity { public function __construct(public int $id = 0, public string $title = '') { parent::__construct(); } }；
• 表类方法参数加联合类型：public function findByStatus(string|int $status): ResultSet；
• 路由闭包里用命名参数：Route::get('/articles/{id}', function (int $id) { ... });——前提是 PHP CLI 和 Web SAPI 真的都运行在 8.0+，别只看 php -v，还要 phpinfo() 核对 Web 环境。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
