Webman的Model不支持Eloquent式with()预加载，因其底层support\Model无关联关系机制；需手动分两步查询：先查主表，再用whereIn()批量查从表，或在模型中显式定义items()等方法实现关联逻辑。
Webman里用Model做一对多查询，为什么with()没生效？
因为Webman默认的support\Model不支持Eloquent式的预加载语法，with()方法根本不存在——直接调用会报Call to undefined method错误。
你看到的with()示例，基本都来自Laravel或ThinkPHP文档，照搬到Webman里只会失败。
- Webman的模型是轻量封装，只提供基础CRUD和简单链式查询，没有内置关系定义机制
- 想实现一对多（比如
Order查多个OrderItem），必须手动分两步：先查主表，再用whereIn()批量查从表 - 如果硬要“模拟”
with()，得自己写个loadItems()方法，在Order模型里显式调用OrderItem::where('order_id', $this->id)->get()
怎么在Webman Model里正确写一对多关联逻辑？
别依赖框架自动推断，把关联逻辑写死在模型方法里，清晰、可控、不踩坑。
假设app\model\Order.php对应orders表，app\model\OrderItem.php对应order_items表，外键是order_id：
立即学习“PHP免费学习笔记（深入）”；
namespace app\model;
use support\Model;
class Order extends Model
{
protected $table = 'orders';
// 显式定义“获取该订单所有子项”
public function items()
{
return OrderItem::where('order_id', $this->id)->get();
}
}
class OrderItem extends Model
{
protected $table = 'order_items';
}
- 调用时用
$order->items()，不是$order->items（后者不会触发查询） - 避免在循环里反复调用
items()，否则变成N+1查询；应先收集所有order_id，再用whereIn()一次查完 - 如果需要返回带嵌套结构的数组（如API响应），建议在Controller里组装：
['order' => $order, 'items' => $items]，而不是塞进模型
Webman中处理一对多时最容易忽略的性能点
字段类型不一致会导致WHERE IN失效或隐式类型转换，查不到数据但无报错，极难排查。
-
orders.id是BIGINT UNSIGNED，那order_items.order_id也必须是同类型，不能是VARCHAR或INT SIGNED - 如果用了UUID作主键（
CHAR(36)），确保两个表字段都是VARCHAR(36)且字符集一致（如utf8mb4） -
whereIn()传入空数组时，Webman底层会生成WHERE 1=0，结果为空——这是正常行为，不是bug，但容易误判为“没查到” - 批量查询时别用
foreach+find()，改用whereIn('id', $ids)，1次SQL比N次快一个数量级
要不要给Webman加ORM关系支持？
可以，但不推荐直接集成Laravel Eloquent——它太重，会拖慢Webman的高性能定位。
更务实的做法是按需补丁：
- 用
illuminate/database（Webman官方推荐）本身已支持QueryBuilder，可手写join一次性查出父子数据，再用PHP分组 - 若项目复杂度上升，考虑在
app\model下封装一个RelationLoader工具类，统一处理belongsTo/hasMany的批量加载逻辑 - 真正需要完整ORM时，说明项目规模已超出Webman轻量定位，该评估迁移到Laravel或Hyperf
关系映射不是越自动越好，Webman的价值恰恰在于让你清楚知道每一行SQL怎么来的。
