一些常用的模型属性

@这是小豪的第三篇文章
今天整理了一下模型属性,权当一个工具使用,方便查阅,欢迎收藏,哈哈。


connection

 /**
  * 为模型指定一个连接名称。
  *
  * @var string
  */
 protected $connection = 'connection-name';

table

/**
 * 为模型指定一个表名。
 *
 * @var string
 */
 protected $table = 'users';

primaryKey

/**
 * 为模型指定主键。
 *
 * @var string
 */
 protected $primaryKey = 'user_id';

keyType

 /**
  * 自定义主键类型。
  *
  * @var string
  */
 protected $keyType = 'string';

incrementing

 /**
  * 如果使用的是非递增或者非数字的主键。
  *
  * @var bool
  */
 public $incrementing = false;

with

class Post extends Model
{
 /**
  * 加载模型关联数据。
  * 
  * @var array
  */
  protected $with = [
      'comments'
  ];
}

《模型关联给我们带来了哪些便利》 有介绍 with 的用法噢。

withCount

class Post extends Model
{
 /**
  * 加载模型关联数据数量。
  * 
  * @var array
  */
  protected $withCount = [
      'comments'
  ];
}

timestamps

 /**
  * 执行模型是否自动维护时间戳.
  *
  * @var bool
  */
 public $timestamps = false;

fillable

/**
 * 可以被批量赋值的属性。
 *
 * @var array
 */
 protected $fillable = ['name', 'age'];

guarded

 /**
  * 不可被批量赋值的属性,当 $guarded 为空数组时则所有属性都可以被批量赋值。
  *
  * @var array
  */
 protected $guarded = ['price'];    

guardedfillable,在当前模型中只能存在一者噢。

CREATED_AT

 /**
  * 创建时间戳字段名称。
  *
  * @var string
  */
 const CREATED_AT = 'created_at';   

UPDATED_AT

 /**
  * 更新时间戳字段名称。
  *
  * @var string
  */
 const UPDATED_AT = 'updated_at';   

attributes

 const STATUS_CREATED = 'created';

 /**
  * 给定字段默认值。
  *
  * @var array
  */
 protected $attributes = [
     'status' => self::STATUS_CREATED,
 ];

casts

 /**
  * 字段转换为对应的类型。
  *
  * @var array
  */
 protected $casts = [
    'id' => 'integer',
    'settings' => 'array',
    'is_admin' => 'boolean',
 ];

dates

 /**
  * 需要转换成日期的属性。
  *
  * @var array
  */
 protected $dates = ['deleted_at'];

dateFormat

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

不清楚 U 是什么意思的,请看 Date/Time 函数

appends

 /**
  * 追加到模型数组表单的访问器。
  *
  * @var array
  */
 protected $appends = ['is_admin'];

一般情况下 appends 都是与 访问器连用的。

hidden

 /**
  * 数组中的属性会被隐藏。
  *
  * @var array
  */
 protected $hidden = ['password'];

visible

 /**
  * 数组中的属性会被展示。
  *
  * @var array
  */
 protected $visible = ['first_name', 'last_name'];

dispatchesEvents

 /**
  * 模型的事件映射。
  *
  * @var array
  */
 protected $dispatchesEvents = [
     'saved' => UserSaved::class,
     'deleted' => UserDeleted::class,
 ];

forceDeleting

 /**
  * 指示模型当前是否强制删除。
  *
  * @var bool
  */
 protected $forceDeleting = false;

perPage

 /**
  * 默认分页数量。
  *
  * @var int
  */
 protected $perPage = 50;

touches

 /**
  * 更新添加的关联模型的 updated_at 字段。
  *
  * @var array
  */
 protected $touches = ['post'];

结束语

欢迎在评论区大家补充噢。

本作品采用《CC 协议》,转载必须注明作者和本文链接
finecho # Lhao
本帖由系统于 5年前 自动加精
《L05 电商实战》
从零开发一个电商项目,功能包括电商后台、商品 & SKU 管理、购物车、订单管理、支付宝支付、微信支付、订单退款流程、优惠券等
《L02 从零构建论坛系统》
以构建论坛项目 LaraBBS 为线索,展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。
讨论数量: 12

还有 withCount ,scope等好多,你这个模型大全有点夸张了

5年前 评论
finecho

@james_xue 大佬批评的是,后面慢慢补充哈

5年前 评论

@james_xue 噢,想要socpe的高级用法 = =

5年前 评论

dataFormats, U 应该是指 Unix Timestamp

5年前 评论
guanhui07

socpe挺赞的

5年前 评论

这个应该放到 laravel 社区吧

5年前 评论
hookover

dispatchesEvents 怎么配置多个事件?
下面这样可以吗?

dispatchesEvents[
  saved => [监听A,监听B]
]
5年前 评论
finecho

@hookover 不可以哦,可以去看一下 HasEvents 的源码, 再者 saved 本身就只能算一个事件吧,如果想处理不同的事情,可以在这个事件下定义不同的监听者,然后再给定 Job 去处理呢

5年前 评论
hookover

@Lhao 简单看源码是不可以的。。

5年前 评论

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!