README

基于 PHP5.6+ 的 ORM 实现，主要特性：

• 基于 ThinkPHP5.1 的 ORM 独立封装
• 支持 Mysql、Pgsql、Sqlite、SqlServer、Oracle 和 Mongodb
• 支持 Db 类和查询构造器
• 支持事务
• 支持模型和关联

适用于不使用 ThinkPHP 框架的开发者。

安装

composer require topthink/think-orm

Db 类用法：

use think\Db;
// 数据库配置信息设置（全局有效）
Db::setConfig(['数据库配置参数（数组）']);
// 进行CURD操作
Db::table('user')
	->data(['name'=>'thinkphp','email'=>'thinkphp@qq.com'])
	->insert();	
Db::table('user')->find();
Db::table('user')
	->where('id','>',10)
	->order('id','desc')
	->limit(10)
	->select();
Db::table('user')
	->where('id',10)
	->update(['name'=>'test']);	
Db::table('user')
	->where('id',10)
	->delete();

Db 类增加的（静态）方法包括：

• setConfig 设置全局配置信息
• getConfig 获取数据库配置信息
• setQuery 设置数据库 Query 类名称
• setCacheHandler 设置缓存对象 Handler（必须支持 get、set 及 rm 方法）
• getSqlLog 用于获取当前请求的 SQL 日志信息（包含连接信息）

其他操作参考 TP5.1 的完全开发手册数据库章节

定义模型：

namespace app\index\model;
use think\Model;
class User extends Model
{
}

代码调用：

use app\index\model\User;

$user = User::get(1);
$user->name = 'thinkphp';
$user->save();

Db 类和模型对比使用

✅ 创建 Create

• Db 用法

  Db::table('user')
      ->insert([
          'name'  => 'thinkphp',
          'email' => 'thinkphp@qq.com',
      ]);

• 模型用法

  $user        = new User;
  $user->name  = 'thinkphp';
  $user->email = 'thinkphp@qq.com';
  $user->save();

• 或者批量设置

  $user = new User;
  $user->save([
      'name'  => 'thinkphp',
      'email' => 'thinkphp@qq.com',
  ]);

✅ 读取 Read

• Db 用法

  $user = Db::table('user')
      ->where('id', 1)
      ->find();
  //  或者
  $user = Db::table('user')
      ->find(1);
  echo $user['id'];
  echo $user['name'];

• 模型用法

  $user = User::get(1);
  echo $user->id;
  echo $user->name;

• 模型实现读取多个记录

  // 查询用户数据集
  $users = User::where('id', '>', 1)
      ->limit(5)
      ->select();
  
  // 遍历读取用户数据
  foreach ($users as $user) {
      echo $user->id;
      echo $user->name;
  }

✅ 更新 Update

• Db 用法

  Db::table('user')
      ->where('id', 1)
      ->update([
          'name'  => 'topthink',
          'email' => 'topthink@qq.com',
      ]);

• 模型用法

  $user        = User::get(1);
  $user->name  = 'topthink';
  $user->email = 'topthink@qq.com';
  $user->save();

• 或者使用

  $user = User::get(1);
  $user->save([
      'name'  => 'topthink',
      'email' => 'topthink@qq.com',
  ]);

• 静态调用

  User::update([
      'name'  => 'topthink',
      'email' => 'topthink@qq.com',
  ], ['id' => 1]);

✅ 删除 Delete

• Db 用法

  Db::table('user')->delete(1);

• 模型用法

  $user = User::get(1);
  $user->delete();

• 或者静态实现

  User::destroy(1);

• 静态调用

  User::update([
      'name'  => 'topthink',
      'email' => 'topthink@qq.com',
  ], ['id' => 1]);

• destroy 方法支持删除指定主键或者查询条件的数据

  // 根据主键删除多个数据
  User::destroy([1, 2, 3]);
  // 指定条件删除数据
  User::destroy([
      'status' => 0,
  ]);
  // 使用闭包条件
  User::destroy(function ($query) {
      $query->where('id', '>', 0)
          ->where('status', 0);
  });

更多模型用法可以参考 5.1 完全开发手册的模型章节