php stander lib


README

Easyswoole-ORM

项目背景

由于swoole协程环境不可以直接使用php-fpm的orm组件(由于存在静态全局变量、连接层没有做好协程处理,无法协程安全地使用)

所以easyswoole花费大量时间精力维护orm组件,连贯操作等功能设计借鉴TP5.0的ORM组件。

有疑问、功能建议、bug反馈请在QQ群、github issue、直接联系宣言提交。

问题反馈模板

一个完整的提问需要包含以下几点:

  • 1.出现了问题,怀疑orm组件的bug,需要先行编写最小测试。(比如一个新的类,单独只调用一个功能,都出问题了,排除其他因素影响)
  • 2.用文字描述出现的问题,附带运行和调试的参数截图
  • 3.附带第一步最小测试复现脚本

安装

composer require easyswoole/orm

RFC

1、Model Invoke

Model::invoke()->where(col,val)->get()
Model::invoke(function(Model $m){
    $m->where(col,val)
})->get()

2、Model Where

$model = Model::create()

//$op => = , > , < , != , in , between
$model->where(col1,val1,$op)->get()
$model->where(col1,100,">")->get()
$model->where(col1,100,"<")->get()
$model->where(col1,100,"=")->get()
$model->where(col1,[1,100],"in")->get()
$model->where(col1,[1,100],"between")->get()

$model->where(col1,val1)->where(col2,val2)->get()
=> select * from where col1 = val1 and col2 = val2 limit 1


// 数组形式传参 仅支持此种格式数组
$array1 = [
    ['user', 'easyswoole', '='],
    ['age', '18', '!='],
];
$array1 = [
    ['creaet_time', '2021-12-29 14:47:32', '='],
];
$model->where($array1)->where($array2)->get()


// TODO 兼容 原生sql

官网文档

http://www.easyswoole.com/Cn/Components/Orm/changeLog.html

单元测试

 ./vendor/bin/co-phpunit tests

推荐使用mysql著名的employees样例库进行测试和学习mysql: https://github.com/datacharmer/test_db

主要项目负责人

参与贡献方式

  • 有实际生产使用的,提出升级迭代建议
  • 使用过程中遇到问题,并且查看文档,基本排除个人原因导致的问题,怀疑bug,及时反馈
  • 参与orm组件的代码维护、功能升级
  • 参与orm组件的文档维护(也就是加入easyswoole文档维护团队)

开源协议

Apache-2.0

功能介绍

  • 基于easyswoole/mysqli组件,承当构造层职责。
  • 基于easyswoole/pool组件,承当基础连接池。
  • 支持执行自定义sql语句、构造器查询。
  • 支持事务,DbManager连接管理器也可承当事务管理器的职责。
  • 支持关联查询。
  • 支持多数据库配置,读写分离。
  • 便捷的连贯操作、聚合操作。

设计层级

设计层级