iCMS 数据操作指南

## iCMS8 数据库操作类使用指南 iCMS8 项目采用了一套完整的 ORM（对象关系映射）系统，主要由以下几个核心组件构成： ### 核心架构 1. **iPHP\core\Model.php** - 模型基类 2. **iPHP\core\database\src\Builder.php** - 查询构建器 3. **iPHP\core\database\src\Connection\Connection.php** - 数据库连接类 4. **config\iCMS\database.php** - 数据库配置文件 ### 数据库配置 系统支持多种数据库驱动（MySQL、SQLite），配置文件中定义了连接参数： - MySQL: 主机、端口、数据库名、用户名、密码等 - SQLite: 数据库文件路径 - 表前缀: `icms_` ### Model 类使用方法 #### 1. 创建模型类 **app\article\ArticleModel.php** ```php class ArticleModel extends Model { // 数据类型转换 protected $casts = [ 'picdata' => 'array', 'nodeAttrs' => 'array', ]; // 事件绑定 protected $events = [ 'delete' => ['ArticleEvent', 'delete'], 'changed' => ['ArticleEvent', 'changed'], ]; } ``` #### 2. 基本查询操作 **查询单条记录：** ```php // 根据主键查询 $article = ArticleModel::get(1); $article = ArticleModel::find(1); $article = ArticleModel::first(); // 根据条件查询 $article = ArticleModel::where('title', 'test')->first(); $article = ArticleModel::where(['status' => 1])->get(); ``` **查询多条记录：** ```php // 查询所有记录 $articles = ArticleModel::select(); $articles = ArticleModel::all(); // 条件查询 $articles = ArticleModel::where('status', 1)->select(); $articles = ArticleModel::where(['cid' => 10])->orderBy('id', 'desc')->select(); ``` #### 3. 复杂查询 **WHERE 条件：** ```php // 基本条件 ArticleModel::where('id', 1) ArticleModel::where('id', '>', 10) ArticleModel::where(['status' => 1, 'cid' => 10]) // IN 查询 ArticleModel::where('id', [1, 2, 3]) // 原生 SQL ArticleModel::where('id = ? AND status = ?', [1, 1]) ``` **联表查询：** ```php $rows = CrmKolModel::as('kol') ->field('id,name,user_id,avatar') ->leftjoin(CrmUserKolModel::as('uk')->getTableName(), 'uk.user_id=kol.user_id') ->field('uk.created,uk.remark,uk.status') ->where(['uk.uid' => $uid]) ->select(); ``` **分页查询：** ```php $articles = ArticleModel::where($where) ->orderby('id', 'desc') ->paging($pageSize); ``` #### 4. 数据操作 **创建记录：** ```php // 单条插入 $id = ArticleModel::create([ 'title' => '标题', 'content' => '内容', 'status' => 1 ]); // 忽略重复 ArticleModel::ignore($data); // 替换插入 ArticleModel::replace($data); ``` **更新记录：** ```php // 根据条件更新 ArticleModel::where('id', 1)->update(['title' => '新标题']); // 更新或创建 ArticleModel::updateOrCreate($data, $where); ``` **删除记录：** ```php // 根据主键删除 ArticleModel::delete(1); // 根据条件删除 ArticleModel::where('status', 0)->delete(); ``` #### 5. 高级功能 **字段选择：** ```php ArticleModel::field('id,title,created')->select(); ``` **排序和限制：** ```php ArticleModel::orderBy('id', 'desc')->limit(10)->select(); ``` **聚合查询：** ```php $count = ArticleModel::count(); $value = ArticleModel::field('title')->value(); // 获取单个值 $ids = ArticleModel::pluck('id'); // 获取某列的值 ``` **数据类型转换：** 系统支持自动类型转换，如 `array`、`json`、`datetime`、`boolean` 等。 **事件系统：** 支持 `creating`、`created`、`updating`、`updated`、`delete`、`deleted`、`geted`、`changed` 等事件钩子。 ### 使用示例 参考 **app\crm\CrmApp.php** 中的实际应用： ```php $rows =CrmKolModel::as('kol') ->field('id,name,user_id,avatar') ->leftjoin(CrmUserKolModel::as('uk')->getTableName(), 'uk.user_id=kol.user_id') ->field('uk.created,uk.remark,uk.status') ->where(['uk.uid' => $uid]) ->select(); ``` 这套 ORM 系统提供了完整的数据库操作功能，支持链式调用、事件系统、类型转换等现代 ORM 特性，使用简单且功能强大。