3分钟短文：Laravel ORM 模型用法纲要

引言

前两期为了说明laravel框架提供的数据库操作能力，直接使用DB门面操作， 而没有引入更为强大的eloquent orm功能。从本期开始，我们就分次把 eloquent的一些简要知识点，为大家提炼演示一下。主要以代码为主，配以简要说明。

学习时间

Eloquent其实是一个 ActiveRecord 类型的 ORM。这是一个位于数据库操作之上的一个中间层， 不仅仅是对于整张表的操作，更能细化到每行记录的增删改查。

创建一个模型类非常简单，只用继承系统的模型就可以了：

 
    
    

  
     
     use Illuminate\Database\Eloquent\Model;
class Contact extends Model {}
 
    
    

因为遵循的是约定大于配置的惯例，所以上述模型如不指定表名，默认就是默认数据库的contacts表了。

对于数据库插入新条目，则可以便捷地使用模型的方法执行，比如下面这样：

 
    
    

  
     
     public function save(Request $request)
{
    $contact = new Contact();
    $contact->first_name = $request->input('first_name');
    $contact->last_name = $request->input('last_name');
    $conatct->email = $request->input('email');
    $contact->save();
    return redirect('contacts');
}
 
    
    

创建一个合约，并使用传入的表单数据填充。接着是使用模型对数据的查询：

 
    
    

  
     
     public function show($contactId)
{
    return Contact::findOrFail($contactId);
}
 
    
    

这里有一个语法糖，就是 findOrFail，如果找到就返回一个模型，找不到就返回默认错误页面。上述方法会对Contact模型调用toArray方法进行格式化，然后返回一个 JsonResponse 对象的响应体。

如果返回的模型想要手动定制一下，那么在查询结果集中，使用Collection提供的格式化功能就好了。

 
    
    

  
     
     public function vips()
{
    return Contact::where('vip', true)->get()->map(function ($contact) {
        $contact->formalName = "The exalted {$contact->first_name} of the {$contact->last_name}s";
        return $contact;
    });
}
 
    
    

大家注意，get方法返回的是一个 Eloquent Collection，包含了Model模型的集合。所以使用map遍历集合元素时， 每个元素其实都是一个独立的Contact对象，直接给对象追加属性就可以增加字段了。

创建模型

除了上面我们使用手动创建模型文件之外，laravel还为我们提供了命令行方式快捷创建。使用下面的指令：

 
    
    

  
     
     php artisan make:model Contact
 
    
    

这样会在 App 命名空间下生成一个标准的模型文件 Contact.php，内容如下：

 
    
    

  
     
     namespace App;
use Illuminate\Database\Eloquent\Model;
class Contact extends Model
{

  
     
     //
  
     
     
}
 
    
    

如果数据库表还没有创建，你想要把迁移文件的骨架代码也生成出来，只需在生成指令上追加参数如下：

 
    
    

  
     
     php artisan make:model Contact --migration
 
    
    

有些时候，我们维护一些数据库和表，想要动态切换某个模型所对应的数据库表， 那么只需在模型文件内手动指定表名即可：

 
    
    

  
     
     protected $table = 'contacts_secondary';
 
    
    

如果你使用的主键不是id，是自定义的字段名，那也可以手动指定：

 
    
    

  
     
     protected $primaryKey = 'contact_id';
 
    
    

这个contact_id是系统维护，而非自增的，你需要显式声明不要自增这个字段：

 
    
    

  
     
     public $incrementing = false;
 
    
    

如果创建的表内有created_at, updated_at等等标准字段，而在数据库表的字段默认值内允许为NULL，或者默认为NULL。你想要他们自动更新为当前系统时间，只需要添加这个配置项：

 
    
    

  
     
     public $timestamps = false;
 
    
    

存储的日期时间格式，也可以自定义：

 
    
    

  
     
     protected $dateFormat = 'Ymd His';
 
    
    

好了，关于模型的基本属性和常用方法，也就这些了。

写在最后

本文通过演示laravel框架模型创建，以及通过演示默认配置项到自定义配置内容， 为大家展示了Model所具备的一些很赞的特性。

Happy coding :-)

我是@程序员小助手，持续分享编程知识，欢迎关注。

本文分享自微信公众号 - 程序员小助手（mql45ea）。
如有侵权，请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”，欢迎正在阅读的你也加入，一起分享。

来源：oschina

链接：https://my.oschina.net/u/4579344/blog/4549954