AI 助理
备案控制台
开发者社区 开发与运维 文章 正文

最为常用的Laravel操作(1)-Eloquent模型

2023-06-30 78
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 整理了 Laravel 框架 Eloquent 模型最常用的操作，包括一些常用的属性、方法，模型关联等。本系列共有 3 篇文章。

快速入门

更换表名

protected $table = 'my_flights';

更换主键名称

protected $primaryKey  = 'id';

注意: Eloquent 默认主键字段是自增的整型数据, 这意味着主键将会被自动转化为 int 类型, 如果你想要使用非自增或非数字类型主键, 必须在对应模型中设置 $incrementing` 属性为 `false` , 如果主键不是整型, 还要设置 `$keyType 属性值为 string.

关闭时间戳记录

public $timestamps = false;

获取模型数据

// Eloquent 的 all 方法返回模型表的所有结果
$flights = App\Flight::all();

foreach ({
   mathJaxContainer[1]}flight) {
   
    echo $flight->name;
}

// 添加约束条件
$flights = App\Flight::where('active', 1)
    ->orderBy('name', 'desc')
    ->take(10)
    ->get();

获取单个模型

// 通过主键获取模型
$flight = App\Flight::find(1);
// 获取匹配查询条件的第一个模型
$flight = App\Flight::where('active', 1)->first();
// 通过传递主键数组来调用 find 方法, 这将会返回匹配记录集合
$flights = App\Flight::find([1, 2, 3]);

获取聚合结果

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

插入记录

$flight = new Flight;
{
   mathJaxContainer[2]}request->name;
$flight->save();

更新模型

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

批量更新

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

删除模型

// 删除
$flight = App\Flight::find(1);
$flight->delete();

// 通过主键删除模型
App\Flight::destroy(1);
App\Flight::destroy([1, 2, 3]);
App\Flight::destroy(1, 2, 3);

// 通过查询删除模型
$deletedRows = App\Flight::where('active', 0)->delete();

软删除

// Eloquent 模型
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes;
class Flight extends Model
{
   
    use SoftDeletes;
    /**
     * 应该被调整为日期的属性
     *
     * @var array
     */
    protected $dates = ['deleted_at'];
}

// 数据表结构添加 deleted_at 列
Schema::table('flights', function ($table) {
   
    $table->softDeletes();
});

// 判断给定模型实例是否被软删除, 可以使用 trashed 方法
if ($flight->trashed()) {
   
    // ...
}

// 查询被软删除的模型
$flights = App\Flight::withTrashed()
    ->where('account_id', 1)
    ->get();
$flight->history()->withTrashed()->get();

// 只获取软删除模型
$flights = App\Flight::onlyTrashed()
    ->where('airline_id', 1)
    ->get();

// 恢复软删除模型
$flight->restore();

// 使用 restore 方法来快速恢复多个模型, 不会触发任何模型事件
App\Flight::withTrashed()
    ->where('airline_id', 1)
    ->restore();
$flight->history()->restore();

本地作用域

/**
 * 只包含活跃用户的查询作用域
 *
 * @return \Illuminate\Database\Eloquent\Builder
 */
public function scopePopular($query)
{
   
    return $query->where('votes', '>', 100);
}

/**
 * 只包含激活用户的查询作用域
 *
 * @return \Illuminate\Database\Eloquent\Builder
 */
public function scopeActive($query)
{
   
    return $query->where('active', 1);
}
// 使用本地作用域
$users = App\User::popular()->active()->orderBy('created_at')->get();

动态作用域

/**
 * 让查询只包含给定类型的用户
 *
 * @param \Illuminate\Database\Eloquent\Builder $query
 * @param mixed $type
 * @return \Illuminate\Database\Eloquent\Builder
 */
public function scopeOfType({
   mathJaxContainer[3]}type)
{
   
    return {
   mathJaxContainer[4]}type);
}
// 使用动态作用域
$users = App\User::ofType('admin')->get();

模型关联

一对一关联

// 拥有
class User extends Model
{
   
    /**
     * 获取关联到用户的手机
     */
    public function phone()
    {
   
        // Phone : 关联的模型
        // Phone : user_id 外键
        // User  : id      主键
        return $this->hasOne('App\Phone', 'user_id', 'id');
    }
}

// 所属
class Phone extends Model
{
   
    /**
     * 获取拥有该手机的用户
     */
    public function user()
    {
   
        // User  : 所属的模型
        // Phone : user_id 外键
        // User  : id      父模型主键
        return $this->belongsTo('App\User', 'user_id', 'id');
    }
}

// 空模型
class Article extends Model
{
   
    /**
     * 获取文章作者
     */
    public function user()
    {
   
        return {
   mathJaxContainer[5]}user) {
   
            $user->name = 'Guest Author';
        });
    }
}

一对多关联

// 拥有
class Post extends Model
{
   
    /**
     * 获取博客文章的评论
     */
    public function comments()
    {
   
        // Comment : 关联的模型
        // Comment : post_id 外键
        // Post    : id      主键
        return $this->hasMany('App\Comment', 'post_id', 'id');
    }
}

// 所属
class Comment extends Model
{
   
    /**
     * 获取评论对应的博客文章
     */
    public function post()
    {
   
        // Post    : 关联的模型
        // Comment : post_id 外键
        // Post    : id      父模型主键
        return $this->belongsTo('App\Post', 'post_id', 'id');
    }
}

多对多关联

// 关联
class User extends Model
{
   
    /**
     * 用户角色
     */
    public function roles()
    {
   
        // Role       : 关联的模型
        // user_roles : 中间表名称
        // user_id    : 对应到模型主键
        // role_id    : 对应到关联主键
        return $this->belongsToMany('App\Role', 'user_roles', 'user_id', 'role_id');
    }
}

// 获取中间表字段, 通过 pivot 属性
$user = App\User::find(1);
foreach ({
   mathJaxContainer[6]}role) {
   
    echo $role->pivot->created_at;
}

// 当 pivot 表包含额外的属性时, 必须定义关联时先指定
return $this->belongsToMany('App\Role')->withPivot('column1', 'column2');

// 自动包含created_at 和 updated_at
return $this->belongsToMany('App\Role')->withTimestamps();

// 更换 pivot 为 subscription, 提升可读性
return $this->belongsToMany('App\Podcast')
            ->as('subscription')
            ->withTimestamps();
$users = User::with('podcasts')->get();
foreach ({
   mathJaxContainer[7]}podcast) {
   
    echo $podcast->subscription->created_at;
}

渴求式加载

// select * from books
$books = App\Book::all();
// select * from authors where id in (1, 2, 3, 4, 5, ...)
$books = App\Book::with('author')->get();
foreach ({
   mathJaxContainer[8]}book) {
   
    echo $book->author->name;
}

// 渴求式加载多个关联关系
$books = App\Book::with('author', 'publisher')->get();

// 嵌套的渴求式加载
$books = App\Book::with('author.contacts')->get();

// 渴求式加载指定字段
// 注: 使用这个特性时, id 字段是必须列出的
$users = App\Book::with('author:id,name')->get(); 

// 带条件约束的渴求式加载
{
   mathJaxContainer[9]}query) {
   
    $query->where('title', 'like', '%first%');
}])->get();

插入 / 更新关联模型

// 插入关联模型
$comment = new App\Comment(['message' => 'A new comment.']);
$post = App\Post::find(1);
// 调用 comments 方法获取关联关系实例, save 将添加 post_id 到 Comment 模型中
{
   mathJaxContainer[10]}comment);

// 保存多个关联模型
$post = App\Post::find(1);
$post->comments()->saveMany([
    new App\Comment(['message' => 'A new comment.']),
    new App\Comment(['message' => 'Another comment.']),
]);

// 使用 create 创建, 与 save 不同的是, 它j接收一个关联数组, create 方法遵循模型属性的批量赋值操作
$post = App\Post::find(1);
{
   mathJaxContainer[11]}post->comments()->create([
    'message' => 'A new comment.',
]);

// 保存多个关联模型
$post = App\Post::find(1);
$post->comments()->createMany([
    [
        'message' => 'A new comment.',
    ],
    [
        'message' => 'Another new comment.',
    ],
]);

// 更新从属关联关系 (belongsTo)
$account = App\Account::find(10);
// associate 方法会在子模型设置外键
{
   mathJaxContainer[12]}account);
$user->save();

// 移除关联 (belongsTo) 
// dissociate 方法会设置关联关系的外键为 null
$user->account()->dissociate();
$user->save();

附加 / 分离多对多关联模型

$user = App\User::find(1);
// 在连接模型的中间表中插入记录
{
   mathJaxContainer[13]}roleId);
// 插入数据和附加的数组到中间表
{
   mathJaxContainer[14]}roleId, ['expires' => $expires]);

// 从中间表中移除相应的记录: 指定用户移除某个角色
{
   mathJaxContainer[15]}roleId);
// 从中间表中移除相应的记录: 指定用户移除所有角色
$user->roles()->detach();

// attach 和 detach 还接收数组形式的 ID 作为输入
$user = App\User::find(1);
$user->roles()->detach([1, 2, 3]);
$user->roles()->attach([
    1 => ['expires' => $expires],
    2 => ['expires' => $expires]
]);

在中间表上保存额外数据

处理多对多关联时, save 方法接收中间表数组作为第二个参数:

App\User::find(1)->roles()->save({
   mathJaxContainer[16]}expires]);

访问器和修改器

访问器和修改器 允许你在获取模型属性或设置其值时格式化 Eloquent 属性.

例如, 你可能想要使用 Laravel 加密器对存储在数据库中的数据进行加密, 并且在 Eloquent 模型中访问时自动进行解密.

除了自定义访问器和修改器, Eloquent 还可以自动转换日期字段为 Carbon 实例甚至 将文本转换为 JSON .

访问器

class User extends Model
{
   
    /**
     * 获取用户的名字
     *
     * @param  string  $value
     * @return string
     */
    public function getFirstNameAttribute($value)
    {
   
        return ucfirst($value);
    }

    /**
    * 获取用户的全名
    *
    * @return string
    */
    public function getFullNameAttribute()
    {
   
        return "{$this->first_name} {$this->last_name}";
    }
}
// 访问 first_name 属性
$firstName = App\User::find(1)->first_name;

修改器

class User extends Model
{
   
    /**
     * 设置用户的名字
     *
     * @param  string  $value
     * @return string
     */
    public function setFirstNameAttribute($value)
    {
   
        {
   mathJaxContainer[18]}value);
    }
}
// 设置 first_name 属性
App\User::find(1)->first_name = 'Sally';

日期修改器

默认情况下, Eloquent 将会转化 created_at 和 updated_at 列的值为 Carbon 实例, 该类继承自 PHP 原生的 Datetime 类, 并提供了各种有用的方法. 你可以自定义哪些字段被自动调整修改, 甚至可以通过重写模型中的 $dates 属性完全禁止调整:

class User extends Model
{
   
    /**
     * 应该被调整为日期的属性
     *
     * @var array
     */
    protected $dates = [
        'created_at', 
        'updated_at', 
        'disabled_at'
    ];
}

// 自动转换并存储到数据库中
$user = App\User::find(1);
$user->disabled_at = Carbon::now();
$user->save();

// 使用 Carbon 提供的方法
$user = App\User::find(1);
return $user->disabled_at->getTimestamp();

模型日期格式

默认情况下, 时间戳的格式是 Y-m-d H:i:s , 可以结合 $dateFormat 属性自定义格式:

class Flight extends Model
{
   
    /**
     * 模型日期的存储格式
     *
     * @var string
     */
    protected $dateFormat = 'U';
}

属性转换

支持的转换类型: integer , real , float , double , string , boolean , object , array , collection , date , datetime 和 timestamp .

如果数据库有一个 JSON 或 TEXT 字段类型包含了序列化 JSON, 可使用 array 转换, 将自动进行 序列化 和 反序列化 .

class User extends Model
{
   
    /**
     * 应该被转化为原生类型的属性
     *
     * @var array
     */
    protected $casts = [
        // 转换 is_admin 属性: 从 integer (0/1) 转换为 boolean
        'is_admin' => 'boolean',
        // 访问 options 属性将会自动从 JSON 反序列化为 PHP 数组
        // 设置 options 属性的值时, 给定数组将会自动转化为 JSON 以供存储
        'options' => 'array',
    ];
}

// is_admin 属性已经被转换了:
if ($user->is_admin) {
   
    //
}

// 自动序列化和反序列化
$user = App\User::find(1);
{
   mathJaxContainer[19]}user->options;
$options['key'] = 'value';
{
   mathJaxContainer[20]}options;
$user->save();

文章来源于本人博客，发布于 2018-06-02，原文链接：https://imlht.com/archives/152/

文章标签：
PHP
数据处理
数据安全/隐私保护
数据格式
数据库
存储
JSON
仁扬
目录
相关文章
被纵养的懒猫
|
Python JavaScript 前端开发
带你读《Python Django Web典型模块 开发实战》之三：用Django设计大型电商的类别表
本书内容涵盖了收费API业务模型的开发、网站防爬虫策略、网站违禁词自查系统的搭建、会员系统的搭建、前后端分离项目的上线部署等大大小小十余个项目模块分析，可以基本解决Django学习者从理论到实践过渡过程中经常会遇到的大部分问题。
被纵养的懒猫
2627 0
wljslmz
|
3月前
|
开发框架 自然语言处理 前端开发
理解Laravel中的Bundles概念及其在开发中的应用
【8月更文挑战第31天】
wljslmz
32 0
土木林森
|
3月前
|
SQL API 数据库
揭开高效数据层构建的秘密武器：Entity Framework Core 分页查询的最佳实践与性能优化技巧全解析
【8月更文挑战第31天】本文以随笔形式详细探讨了如何在Entity Framework Core中实现分页查询的最佳实践。通过创建基于EF Core的项目，配置数据库上下文，并定义领域模型，文章展示了如何使用`Skip()`和`Take()`方法进行分页查询。此外，还介绍了如何使用惰性加载、显式加载和预加载来优化性能，并通过投影技术减少不必要的数据加载。最后，文章强调了分页查询对于提升应用性能和用户体验的重要性。
土木林森
65 0
蓝易云
|
4月前
|
安全 PHP 数据库
laravel中模型中$fillable的用法
通过正确使用 `$fillable`属性，开发者可以有效地保护应用免受批量赋值漏洞的影响。它使得只有指定的字段可以被外部用户输入影响，为应用数据的安全性提供了一道防线。在开发使用Laravel框架的应用时，恰当地设置 `$fillable`或 `$guarded`属性是一项最佳实践。
蓝易云
125 1
做梦都在改BUG
|
5月前
|
缓存 监控 中间件
探究Django中间件的神奇：功能、应用场景和核心方法
在Django中，中间件是一个强大的概念，它们提供了一种灵活的方式来处理请求和响应。本文将探讨Django中间件的基本概念、常见应用场景以及中间件类中的父类和核心方法。
做梦都在改BUG
87 2
啊猪是的读来过倒
|
5月前
|
数据库 开发者 Python
Django ORM入门指南：从概念到实践，掌握模型创建、迁移与视图操作
Django ORM入门指南：从概念到实践，掌握模型创建、迁移与视图操作
啊猪是的读来过倒
64 0
老马啸西风2024
|
6月前
|
前端开发 JavaScript API
blog-engine-07-gatsby 建极速网站和应用程序 基于React的最佳框架，具备性能、可扩展性和安全性。
探索多种博客引擎：Jekyll, Hugo, Hexo, Pelican, Gatsby, VuePress, Nuxt.js 和 Middleman。了解Gatsby，基于React的静态站点生成器，以其特性如React基础、静态生成、广泛插件支持、简便部署和现代开发流程脱颖而出。安装Gatsby需先安装Node.js，然后通过`gatsby-cli`创建新站点。开发涉及编写页面、本地开发、生成静态文件及部署。尽管Gatsby具有现代化和高性能优势，但也存在学习曲线和配置复杂性的挑战。
老马啸西风2024
60 0
antony王中阳
|
SQL IDE PHP
Laravel Eloquent 模型 使用技巧
Laravel Eloquent 模型使用技巧
antony王中阳
138 0
仁扬
|
PHP 索引
最为常用的Laravel操作(3)-模板
整理了 Laravel 框架模板最常用的操作，如模板常用语法、模板继承、流程控制、循环等。本系列共有 3 篇文章。
仁扬
73 0
授客
|
测试技术 数据库 数据安全/隐私保护
Django 继承AbstractUser扩展用户模型
Django 继承AbstractUser扩展用户模型
授客
131 0

热门文章

最新文章

  • 1
    Java 生成 UUID
  • 2
    一文读懂 Serverless 的起源、发展和落地实践
  • 3
    Fiddler抓包：下载、安装及使用
  • 4
    用CodeViz绘制函数调用关系图(call graph)
  • 5
    阿里AI上岗双11服装车间，能识别头发丝直径十分之一的瑕疵
  • 6
    SpringBoot开发案例之整合Dubbo提供者(一)
  • 7
    Dubbo架构介绍
  • 8
    警惕垃圾邮件借加沙新闻进行钓鱼攻击
  • 9
    美国博客刊文发布NetApp StoreVault停产通知
  • 10
    IntelliJ IDEA 12 创建Web项目 教程 超详细版
  • 1
    通义灵码与云计算平台的融合：基础与概述
    36
  • 2
    《深度解析：死锁的“前世今生”与防范之道》
    29
  • 3
    《探秘程序崩溃：核心转储（Core Dump）分析全攻略》
    34
  • 4
    今日 AI 开源｜共 12 项｜开源的DIY健康追踪项目，基于低成本的智能戒指构建私人的健康监测应用
    37
  • 5
    Open Interpreter：AI 赋能终端！在终端中对话AI模型进行编程，通过运行代码来完成各种计算机操作任务
    29
  • 6
    「Mac畅玩鸿蒙与硬件15」鸿蒙UI组件篇5 - Slider 和 Progress 组件
    39
  • 7
    ai断点怎么做?
    15
  • 8
    AI Shell：在命令行里“对话” AI ，微软推出将 AI 助手引入命令行的 CLI 工具，打造对话式交互命令行
    19
  • 9
    ai怎么设计迷宫字体效果?
    15
  • 10
    「Mac畅玩鸿蒙与硬件14」鸿蒙UI组件篇4 - Toggle 和 Checkbox 组件
    29

    • 相关课程

    更多
  • PHP进阶教程 - 由浅入深掌握面向对象开发 - 第二阶段
  • SQL基础开发与应用

    • 相关电子书

    更多
  • OpenStack Swift 海量小文件性能优化之路
  • OpenStack Swift 海量小文件优化之路
  • ui-model，跨框架复用

    • 相关实验场景

    更多
  • 语言入门-1：环境构建
  • 零基础部署一个Django Blog到Serverless架构
  • 基于函数计算快速搭建Zblog等传统应用框架
    • 下一篇
    阿里云OSS设置跨域访问