ORM模型简介

ORM模型简介

1>什么是ORM？

ORM，即 Object-Relational Mapping（对象关系映射），它的作用是在关系型数据库和业务实体对象之间作一个映射，这样，我们在操作具体的 业务对象时，就不需要再去和复杂的SQL语句打交道，只需简单的操作对象的属性和方法即可。

2>ORM 两种最常见的实现方式是 ActiveRecord 和 DataMapper，

ActiveRecord(非常流行) 中模型与数据表一一对应，

DataMapper 中模型与数据表是完全分离的。

3>Eloquent ORM 使用 ActiveRecord 实现方式，每一个 Eloquent 模型类对应着数据库中的一张表，我们通过调用模型类的相应方法实现对数据库的增删改查。

一.定义模型

1.1创建model模型

1>模型通常放在 app 目录中，不过你可以将他们随意放在任何可通过 composer.json 自动加载的地方。(我们建议在app下建立models文件夹)

2>所有的 Eloquent 模型都继承自 Illuminate\Database\Eloquent\Model 类。

3>创建模型实例的最简单方法是使用 make:model artisan命令

php artisan make:model Flight

4>然后将文件移动到models文件夹下,再更改下命名空间

1.2模型约定

　　主要是以下几个方面:表名,主键,时间,日期格式,数据库

class Flight extends Model
{
    /**
     * 与模型关联的数据表。
     */
    protected $table = 'my_flights';

/**
     * 指定主键。
     */
public $primaryKey = 'id';

/**
     * 指定是否模型应该被戳记时间。
     */
    public $timestamps = false;

/**
     * 模型的日期字段保存格式。
     */
    protected $dateFormat = 'U';

/**
     * 此模型的连接名称。
     */
    protected $connection = 'connection-name';
}

分别解释上面的定义:

1>除非数据表明确地指定了其它名称，否则将使用类的「蛇形名称」、复数形式名称来作为数据表的名称。例子中，Eloquent 将会假设 Flight 模型被存储记录在 flights 数据表中

2>Eloquent 也会假设每个数据表都有一个叫做 id 的主键字段。你也可以定义一个 $primaryKey 属性来重写这个约定。

3>默认情况下，Eloquent 会预计你的数据表中有 created_at 和 updated_at 字段。如果你不希望让 Eloquent 来自动维护这两个字段，可在模型内将 $timestamps 属性设置为 false：

4>如果你需要自定义自己的时间戳格式，可在模型内设置 $dateFormat 属性。这个属性决定了日期应如何在数据库中存储，以及当模型被序列化成数组或 JSON 时的格式：

5>默认情况下，所有的 Eloquent 模型会使用应用程序中默认的数据库连接设置。如果你想为模型指定不同的连接，可以使用 $connection 属性：

二.添加模型（增）

1>基本添加,save方法

返回值：true或者false

//首先创建一个新模型实例
$flight = new Flight;
//给这个模型添加属性
$flight->name = $name;
$flight->length = $length;
//... 其它更多属性
$flight->save();

此时created_at 以及 updated_at 时间戳将会被自动设置

2>批量赋值,create方法

返回值：Eloquent 模型实例

批量赋值就是我们不必像前面那样一个个定义模型属性，我们可以传递一个数组给模型类（这个数组通常是表单）

$flight = Flight ::create(Input::all());

　　这个方法有个前提条件，出于安全考虑，我们需要在model中设置黑名单（不可以被赋值的属性 protected $guarded = ['price']）或者白名单（可以被赋值的属性 protected $fillable = ['name']）,如果不设置的话会报错

注意：如果设置了protected $guarded = ['price']

 $input = [ 'name'=>'test',
　　'content'=>'testflight',
　　'length'=>2000,
　　// 'price'=>1880, 即使这里写了价格，因为是受保护的，调用下面的create，也不会插入成功 

 ];
 $flight = Flight ::create($input);
 //如果想成功，那么就重新定义一下属性，然后调用save方法
 $flight ->price= 200; 
 $flight ->save();

3>如果想要批量插入数据

返回值:true或者false

//$data是可以是二维数组
Flight::insert($data)

4>另外两个方法

// 用属性取回航班，当结果不存在时创建它...

返回值是Eloquent 模型实例

$flight = App\Flight::firstOrCreate(['name' => 'Flight 10']);

// 用属性取回航班，当结果不存在时实例化一个新实例，此时尚未存入数据库，可以使用save方法存储

　　$flight = App\Flight::firstOrNew(['name' => 'Flight 10']);
　　$flight->save(); //存入到数据库

三.删除模型（删）

1>要删除模型,在模型实例上调用 delete 方法：

返回值是true或者false

$flight = App\Flight::find(1);
　　//先从是数据库中取回数据
　　$flight->delete(); //实现删除

2>如果你知道模型的主键，可以不取回模型，直接删除

返回值是被删除记录数

App\Flight::destroy(1);
　　App\Flight::destroy([1, 2, 3]);
　　App\Flight::destroy(1, 2, 3);

3>通过查找来删除

返回值是删除条数

$deletedRows = App\Flight::where('active', 0)->delete();

四.更新模型（改）

1>使用save方法

返回值：true或者false

　　$flight = App\Flight::find(1);
　　$flight->name = 'New Flight Name';
　　$flight->save();

2>使用update方法，同样要用到批量赋值（黑名单和白名单也起作用）

返回值：返回更新的条数

App\Flight::where('active', 1) ->where('destination', 'San Diego') ->update(['delayed' => 1]);

五.取回模型（查）

1>取回多个模型

每个 Eloquent 模型想像成强大的查询构造器，它让你可以流畅地查找与模型关联的数据表,可以通过相对应的属性来访问模型的字段值。

$flights = Flight::all();

//我们遍历查找每个返回的flight实例,并且输出每个实例的name字段
foreach ($flights as $flight) {
    echo $flight->name;
}

可以增加限制

$flights = App\Flight::where('active', 1) ->orderBy('name', 'desc') ->take(10) ->get();

分块结果

Flight::chunk(200, function ($flights) { 
　　　　foreach ($flights as $flight) { 
　　　　　　// 
　　　　} 
　　});

总结:

　　<1>all和get等方法返回一个 Illuminate\Database\Eloquent\Collection 实例,这个实例中包含多个Eloquent 模型,Collection 类提供多种辅助函数来处理 Eloquent 结果。我们也可以简单地像数组一样来遍历集合：

　　<2>Eloquent 模型是查询构造器，因此你应当去阅读所有查询构造器中可用的方法。你可在 Eloquent 查找中使用这其中的任何方法。

2>取回单个模型

这些方法返回的是单个模型的实例，而不是返回模型的集合：

$flight = App\Flight::find(1);
// 通过主键取回一个模型...
$flight = App\Flight::where('active', 1)->first();
// 取回符合查找限制的第一个模型 ...
 $model = App\Flight::findOrFail(1);
//找不到模型时抛出一个异常
$model = App\Flight::where('legs', '>', 100)->firstOrFail();

3>其他一些连贯操作

使用 count、sum、max，和其它查询构造器提供的集合函数。这些方法会返回适当的标量值，而不是一个完整的模型实例：

$count = App\Flight::where('active', 1)->count(); 
　　$max = App\Flight::where('active', 1)->max('price');

关于返回值的实际操作传送门:laravel框架之返回值