Hyperf 不提供数据库视图创建命令，需在 MySQL 中手动创建视图，再通过模型映射查询；模型需禁用时间戳、指定表名，视图仅支持只读；复杂视图影响性能，建议基表加索引；也可用 Query Builder 替代以提升灵活性。
Hyperf 本身不直接提供类似 Laravel 的数据库视图（View）创建命令或 ORM 层级的「视图模型」概念，它基于 Swoole 的协程 MySQL 客户端（如 hyperf/database），操作的是真实数据表。所谓“数据库视图”，需在 MySQL 层手动创建，再通过 Hyperf 的模型映射查询——不是框架生成视图，而是使用数据库视图。
MySQL 中创建视图（前提步骤）
视图是 SQL 层的虚拟表，由 SELECT 查询定义。必须先在数据库中创建好，Hyperf 才能像查普通表一样查它：
- 登录 MySQL，执行类似语句：
CREATE VIEW user_profile AS SELECT u.id, u.username, u.email, COUNT(o.id) AS order_count FROM users u LEFT JOIN orders o ON u.id = o.user_id GROUP BY u.id, u.username, u.email;
- 确保视图名符合命名规范（如小写、下划线），避免关键字冲突；
- 视图依赖的基表权限需赋予运行 Hyperf 的数据库账号（SELECT 权限必需）；
- 视图不支持写入（INSERT/UPDATE/DELETE），除非是简单单表视图且满足可更新条件——生产中建议只读使用。
Hyperf 中定义视图模型
把视图当普通数据表看待，新建一个 Model 类，指定 $table 为视图名，并关闭时间戳和主键自动管理（若视图无标准主键或自增字段）：
namespace App\Model;
use Hyperf\DbConnection\Model\Model;
class UserProfile extends Model
{
protected $table = 'user_profile'; // 对应 MySQL 视图名
public $timestamps = false; // 视图通常无 created_at/updated_at
protected $primaryKey = 'id'; // 若视图有明确主键字段，可指定；否则设为 null 或留空
protected $fillable = []; // 视图不可写，填空数组更安全
}
- 无需迁移文件，视图结构由 SQL 定义，Model 只负责映射；
- 查询时与普通模型完全一致：
UserProfile::where('order_count', '>', 5)->get()； - 如果视图字段含 MySQL 函数计算结果（如
DATE(created_at)），可在模型中用$casts或访问器（getXXXAttribute）做类型转换。
注意事项与常见问题
- 性能敏感：视图本质是实时执行底层 SELECT，复杂 JOIN + GROUP BY 的视图可能拖慢查询，建议对关键字段加索引（在基表上建，非视图上）；
-
模型验证失效：Eloquent/Hyperf Model 的
$fillable、$casts等仅影响读写逻辑，不改变视图定义，字段变更需同步修改 SQL 视图； -
事务与缓存：视图查询可参与事务，但结果无法被 Hyperf 的
@Cacheable直接装饰（因无主键或变化不可控），如需缓存，建议用Cache::get手动封装； -
调试技巧：开启
db.logger日志，确认实际执行的 SQL 是否命中视图，避免误查成同名临时表。
替代方案：用 Query Builder 封装逻辑
若视图逻辑简单或变动频繁，更推荐在 Service 层用 Query Builder 直接构造查询，而非维护一堆视图：
use Hyperf\Database\Query\Builder;
$users = (new Builder())->from('users as u')
->leftJoin('orders as o', 'u.id', '=', 'o.user_id')
->selectRaw('u.id, u.username, u.email, COUNT(o.id) as order_count')
->groupBy('u.id', 'u.username', 'u.email')
->havingRaw('COUNT(o.id) > ?', [0])
->get();
- 逻辑集中、易测试、免 DB 权限管控；
- 配合协程池复用连接，性能不输视图；
- 适合多租户、动态条件等场景，灵活性远高于静态视图。
