前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >跟我一起学Laravel-EloquentORM基础部分

跟我一起学Laravel-EloquentORM基础部分

作者头像
用户2131907
发布2019-02-27 13:06:27
8450
发布2019-02-27 13:06:27
举报
文章被收录于专栏:程序猿成长计划

使用Eloquent [‘eləkwənt] 时,数据库查询构造器的方法对模型类也是也用的,使用上只是省略了DB::table('表名')部分。

在模型中使用protected成员变量$table指定绑定的表名。

代码语言:javascript
复制
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Flight extends Model
{
    /**
     * The table associated with the model.
     *
     * @var string
     */
    protected $table = 'my_flights';
}

Eloquent 假设每个表都有一个名为id的主键,可以通过$primaryKey成员变量覆盖该字段名称,另外,Eloquent假设主键字段是自增的整数,如果你想用非自增的主键或者非数字的主键的话,必须指定模型中的public属性$incrementing为false。

默认情况下,Eloquent期望表中存在created_atupdated_at两个字段,字段类型为timestamp,如果不希望这两个字段的话,设置$timestamps为false

代码语言:javascript
复制
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Flight extends Model
{
    /**
     * Indicates if the model should be timestamped.
     *
     * @var bool
     */
    public $timestamps = false;

    /**
     * The storage format of the model's date columns.
     *
     * @var string
     */
    protected $dateFormat = 'U';
}

使用protected $connection = 'connection-name'指定模型采用的数据库连接。

查询

基本查询操作

方法all用于返回模型表中所有的结果

代码语言:javascript
复制
$flights = Flight::all();
foreach ($flights as $flight) {
    echo $flight->name;
}

也可以使用get方法为查询结果添加约束

代码语言:javascript
复制
$flights = App\Flight::where('active', 1)
     ->orderBy('name', 'desc')
     ->take(10)
     ->get();

可以看到,查询构造器的方法对模型类也是可以使用的

在eloquent ORM中,getall方法查询出多个结果集,它们的返回值是一个Illuminate\Database\Eloquent\Collection对象,该对象提供了多种对结果集操作的方法

代码语言:javascript
复制
public function find($key, $default = null);
public function contains($key, $value = null);
public function modelKeys();
public function diff($items)
...

该对象的方法有很多,这里只列出一小部分,更多方法参考API文档 Collection使用说明文档

对大量结果分段处理,同样是使用chunk方法

代码语言:javascript
复制
Flight::chunk(200, function ($flights) {
    foreach ($flights as $flight) {
        //
    }
});

查询单个结果

使用findfirst方法查询单个结果,返回的是单个的模型实例

代码语言:javascript
复制
// 通过主键查询模型...
$flight = App\Flight::find(1);

// 使用约束...
$flight = App\Flight::where('active', 1)->first();

使用find方法也可以返回多个结果,以Collection对象的形式返回,参数为多个主键

代码语言:javascript
复制
$flights = App\Flight::find([1, 2, 3]);

如果查询不到结果的话,可以使用findOrFail或者firstOrFail方法,这两个方法在查询不到结果的时候会抛出Illuminate\Database\Eloquent\ModelNotFoundException异常

代码语言:javascript
复制
$model = App\Flight::findOrFail(1);
$model = App\Flight::where('legs', '>', 100)->firstOrFail();

如果没有捕获这个异常的话,laravel会自动返回给用户一个404的响应结果,因此如果希望找不到的时候返回404,是可以直接使用该方法返回的

代码语言:javascript
复制
Route::get('/api/flights/{id}', function ($id) {
    return App\Flight::findOrFail($id);
});

查询聚集函数结果

与查询构造器查询方法一样,可以使用聚集函数返回结果,常见的比如maxminavgsumcount

代码语言:javascript
复制
$count = App\Flight::where('active', 1)->count();
$max = App\Flight::where('active', 1)->max('price');

分页查询

分页查询可以直接使用paginate函数

代码语言:javascript
复制
LengthAwarePaginator paginate( 
    int $perPage = null, 
    array $columns = array('*'), 
    string $pageName = 'page', 
    int|null $page = null
)

参数说明

参数

类型

说明

perPage

int

每页显示数量

columns

array

查询的列名

pageName

string

页码参数名称

page

int

当前页码

返回值为 LengthAwarePaginator 对象。

代码语言:javascript
复制
$limit = 20;
$page = 1;
return Enterprise::paginate($limit, ['*'], 'page', $page);

插入

基本插入操作

插入新的数据只需要创建一个新的模型实例,然后设置模型属性,最后调用save方法即可

代码语言:javascript
复制
$flight = new Flight;
$flight->name = $request->name;
$flight->save();

在调用save方法的时候,会自动为created_atupdated_at字段设置时间戳,不需要手动指定

批量赋值插入

使用create方法可以执行批量为模型的属性赋值的插入操作,该方法将会返回新插入的模型,在执行create方法之前,需要先在模型中指定fillableguarded属性,用于防止不合法的属性赋值(例如避免用户传入的is_admin属性被误录入数据表)。

指定$fillable属性的目的是该属性指定的字段可以通过create方法插入,其它的字段将被过滤掉,类似于白名单,而$guarded则相反,类似于黑名单。

代码语言:javascript
复制
protected $fillable = ['name'];
// OR
protected $guarded = ['price'];

执行create操作就只有白名单或者黑名单之外的字段可以更新了

代码语言:javascript
复制
$flight = App\Flight::create(['name' => 'Flight 10']);

除了create方法,还有两外两个方法可以使用firstOrNewfirstOrCreate

firstOrCreate方法用来使用给定的列值对查询记录,如果查不到则插入新的。fristOrNewfirstOrCreate类似,不同在于如果不存在,它会返回一个新的模型对象,不过该模型是未经过持久化的,需要手动调用save方法持久化到数据库。

代码语言:javascript
复制
// 使用属性检索flight,如果不存在则创建...
$flight = App\Flight::firstOrCreate(['name' => 'Flight 10']);

// 使用属性检索flight,如果不存在则创建一个模型实例...
$flight = App\Flight::firstOrNew(['name' => 'Flight 10']);

更新

基本更新操作

方法save不仅可以要用来插入新的数据,也可以用来更新数据,只需先使用模型方法查询出要更新的数据,设置模型属性为新的值,然后再save就可以更新了,updated_at字段会自动更新。

代码语言:javascript
复制
$flight = App\Flight::find(1);
$flight->name = 'New Flight Name';
$flight->save();

也可使用update方法对多个结果进行更新

代码语言:javascript
复制
App\Flight::where('active', 1)
    ->where('destination', 'San Diego')
    ->update(['delayed' => 1]);

删除

基本删除操作

使用delete方法删除模型

代码语言:javascript
复制
$flight = App\Flight::find(1);
$flight->delete();

上述方法需要先查询出模型对象,然后再删除,也可以直接使用主键删除模型而不查询,使用destroy方法

代码语言:javascript
复制
App\Flight::destroy(1);
App\Flight::destroy([1, 2, 3]);
App\Flight::destroy(1, 2, 3);

使用约束条件删除,返回删除的行数

代码语言:javascript
复制
$deletedRows = App\Flight::where('active', 0)->delete();

软删除

软删除是在表中增加deleted_at字段,当删除记录的时候不会真实删除记录,而是设置该字段的时间戳,由Eloquent模型屏蔽已经设置该字段的数据。

要启用软删除,可以在模型中引用Illuminate\Database\Eloquent\SoftDeletes这个Trait,并且在dates属性中增加deleted_at字段。

代码语言:javascript
复制
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes;

class Flight extends Model
{
    use SoftDeletes;

    /**
     * The attributes that should be mutated to dates.
     *
     * @var array
     */
    protected $dates = ['deleted_at'];
}

要判断一个模型是否被软删除了的话,可以使用trashed方法

代码语言:javascript
复制
if ($flight->trashed()) {
    //
}
查询软删除的模型
包含软删除的模型

如果模型被软删除了,普通查询是不会查询到该结果的,可以使用withTrashed方法强制返回软删除的结果

代码语言:javascript
复制
$flights = App\Flight::withTrashed()
      ->where('account_id', 1)
      ->get();

// 关联操作中也可以使用
$flight->history()->withTrashed()->get();
只查询软删除的模型
代码语言:javascript
复制
$flights = App\Flight::onlyTrashed()
      ->where('airline_id', 1)
      ->get();
还原软删除的模型

查询到软删除的模型实例之后,调用restore方法还原

代码语言:javascript
复制
$flight->restore();

也可以在查询中使用

代码语言:javascript
复制
App\Flight::withTrashed()
    ->where('airline_id', 1)
    ->restore();

// 关联操作中也可以使用
$flight->history()->restore();
强制删除(持久化删除)
代码语言:javascript
复制
// Force deleting a single model instance...
$flight->forceDelete();

// Force deleting all related models...
$flight->history()->forceDelete();

上述操作后,数据会被真实删除。


参考:

本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2016-03-25,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 查询
    • 基本查询操作
      • 查询单个结果
        • 查询聚集函数结果
          • 分页查询
          • 插入
            • 基本插入操作
              • 批量赋值插入
              • 更新
                • 基本更新操作
                • 删除
                  • 基本删除操作
                    • 软删除
                      • 查询软删除的模型
                  相关产品与服务
                  数据库
                  云数据库为企业提供了完善的关系型数据库、非关系型数据库、分析型数据库和数据库生态工具。您可以通过产品选择和组合搭建,轻松实现高可靠、高可用性、高性能等数据库需求。云数据库服务也可大幅减少您的运维工作量,更专注于业务发展,让企业一站式享受数据上云及分布式架构的技术红利!
                  领券
                  问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档