updateOrCreate

既存のモデルを更新したり、モデルが存在しない場合は新しいモデルを作成したりするシナリオが発生する場合もあります。 Laravel には、たった 1 ステップで実装できる updateOrCreate メソッドが用意されています。 firstOrCreate メソッドと同様、updateOrCreate は対応するモデルと一致するため、save() メソッドを呼び出す必要はありません:

// 如果有从奥克兰到圣地亚哥的航班，则价格定为99美元。
// 如果没匹配到存在的模型，则创建一个。
$flight = App\Flight::updateOrCreate( 
   ['departure' => 'Oakland', 'destination' => 'San Diego'],    
   ['price' => 99]
 );

モデルの削除

モデル インスタンスで delete メソッドを呼び出してインスタンスを削除できます:

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

主キーによるモデルの削除

上記の例では、delete を呼び出す前に、データベース内で対応するモデルを見つける必要があります。実際、モデルの主キーがわかっている場合は、データベース内でモデルを検索せずに、destroy メソッドを直接使用してモデルを削除できます。 destroy このメソッドは、単一の主キーをパラメーターとして受け入れるだけでなく、複数の主キーも受け入れるか、配列またはコレクションを使用して複数の主キーを保存します。

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

クエリ モデルによる削除

モデルに対して削除ステートメントを実行することもできます。この例では、非アクティブとしてマークされたすべてのフライトを削除します。バッチ更新と同様に、バッチ削除では、削除されたモデルのモデル イベントはトリガーされません:

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

{note} Eloquent を通じてバッチ削除ステートメントを実行する場合、deleting および 削除されました モデルイベント。したがって、delete ステートメントを実行する場合、モデルの例は決して取得されません。

deleted_at 属性がモデルに設定され、その値がデータベースに書き込まれます。 deleted_at 値が空でない場合は、モデルが論理的に削除されたことを意味します。モデルのソフト削除機能を有効にしたい場合は、モデルで Illuminate\Database\Eloquent\SoftDeletes トレイトを使用する必要があります:

<?php
    namespace App;
    use Illuminate\Database\Eloquent\Model;
    use Illuminate\Database\Eloquent\SoftDeletes;
    class Flight extends Model{
        use SoftDeletes;
       }

{tip}

SoftDeletes トレイトは、deleted_at 属性を DateTime / Carbon インスタンス

deleted_at フィールドがデータ テーブルに追加されます。 Laravel のデータベース移行には、このフィールドを作成するメソッドがあります:

Schema::table('flights', function (Blueprint $table) 
{  
  $table->softDeletes();
});

delete メソッドを使用すると、現在の日付と時刻が deleted_at に書き込まれます。 ＃＃＃ 分野。同時に、クエリ結果では論理的に削除されたレコードが自動的に除外されます。

メソッドを使用して、現在のモデルが論理的に削除されたかどうかを確認できます:

if ($flight->trashed()) {
    //
 }

論理的に削除されたモデルを含める

前述したように、クエリ結果には論理的に削除された結果が自動的に除外されます。もちろん、withTrashed メソッドを使用して、論理的に削除されたモデルを含むモデルを取得できます:

$flights = App\Flight::withTrashed()           
     ->where('account_id', 1)                
     ->get();

withTrashed このメソッドは関連クエリでも使用できます:

$flight->history()->withTrashed()->get();

論理的に削除されたモデルの取得

onlyTrashed メソッド Only 論理的に削除されたモデルを取得します:

$flights = App\Flight::onlyTrashed()           
     ->where('airline_id', 1)                
     ->get();

論理的に削除されたモデルの復元

論理的に削除されたモデルが「元に戻される」場合は、論理的に削除されたデータに対して restore メソッドを使用して、データを復元することができます。有効な状態:

$flight->restore();

クエリで restore メソッドを使用して、複数のモデルを迅速に復元することもできます。他のバッチ操作と同様、この操作はモデル内のイベントをトリガーしません。

App\Flight::withTrashed()     
   ->where('airline_id', 1)        
   ->restore();

withTrashed メソッドと同様に、restore メソッドも関連付けで使用されます。

$flight->history()->restore();

永久削除

実際にデータを削除するには、forceDelete メソッドを使用します。

// 单个模型实例的永久删除...
$flight->forceDelete();
// 关联模型的永久删除...
$flight->history()->forceDelete();

Soft Delete

Illuminate\Database\Eloquent\Scope

apply メソッドを実装します。必要に応じて、apply メソッドにクエリの where 条件を追加します。

<?php
    namespace App\Scopes;
    use Illuminate\Database\Eloquent\Scope;
    use Illuminate\Database\Eloquent\Model;
    use Illuminate\Database\Eloquent\Builder;
    class AgeScope implements Scope{  
      /**
     * 把约束加到 Eloquent 查询构造中。
     *
     * @param  \Illuminate\Database\Eloquent\Builder  $builder
     * @param  \Illuminate\Database\Eloquent\Model  $model
     * @return void
     */  
      public function apply(Builder $builder, Model $model)  
        {       
         $builder->where('age', '>', 200);   
         }
      }

メソッドの代わりに

addSelect メソッドを使用する必要があります。これにより、既存の選択ステートメントが不注意で置き換えられることを効果的に防止できます。

boot

メソッド:

<?php
    namespace App;use App\Scopes\AgeScope;
    use Illuminate\Database\Eloquent\Model;
    class User extends Model{  
      /**
     *  模型的 「启动」 方法.
     *
     * @return void
     */  
     protected static function boot()  
       {     
          parent::boot();        
          static::addGlobalScope(new AgeScope);  
        }
   }

select * from `users` where `age` > 200

匿名グローバル スコープ

<?php
    namespace App;
    use Illuminate\Database\Eloquent\Model;
    use Illuminate\Database\Eloquent\Builder;
    class User extends Model{  
      /**
     *模型的「启动」方法.
     *
     * @return void
     */  
     protected static function boot()   
      {      
        parent::boot();        
        static::addGlobalScope('age', function (Builder $builder) {  
                  $builder->where('age', '>', 200);       
                }); 
       }
   }

グローバル スコープをキャンセルする

現在のクエリのグローバル スコープをキャンセルする必要がある場合は、withoutGlobalScope メソッドを使用する必要があります。このメソッドは、唯一のパラメータとしてグローバル スコープのクラス名のみを受け入れます:

User::withoutGlobalScope(AgeScope::class)->get();

または、グローバル スコープの定義にクロージャが使用されている場合:

User::withoutGlobalScope('age')->get();

一部またはすべてをキャンセルする必要がある場合グローバル スコープの場合、withoutGlobalScopes メソッドを使用する必要があります:

// 取消所有的全局作用域...
User::withoutGlobalScopes()->get();
// 取消部分全局作用域...
User::withoutGlobalScopes([ 
   FirstScope::class, SecondScope::class
 ])->get();

scope プレフィックスを追加するだけです:

<?php
    namespace App;
    use Illuminate\Database\Eloquent\Model;
    class User extends Model{  
      /**
     * 只查询受欢迎的用户的作用域.
     *
     * @param \Illuminate\Database\Eloquent\Builder $query
     * @return \Illuminate\Database\Eloquent\Builder
     */   
      public function scopePopular($query)  
        {      
          return $query->where('votes', '>', 100);   
        }    
     /**
     * 只查询 active 用户的作用域.
     *
     * @param \Illuminate\Database\Eloquent\Builder $query
     * @return \Illuminate\Database\Eloquent\Builder
     */  
      public function scopeActive($query)  
        {      
          return $query->where('active', 1);  
         }
      }

scope プレフィックスを含める必要はありません。複数のスコープへの呼び出しをチェーンすることもできます。例:

$users = App\User::popular()->active()->orderBy('created_at')->get();

or クエリ ランナーと統合します。クロージャ コールバックの使用が必要になる場合があります:

$users = App\User::popular()->orWhere(function (Builder $query) {
    $query->active();
   })->get();

orWhere メソッドを提供しています。これにより、クロージャを使用せずに呼び出しスコープを連鎖させることができます。

$users = App\User::popular()->orWhere->active()->get();

$query パラメータの後に配置する必要があります:

<?php
    namespace App;
    use Illuminate\Database\Eloquent\Model;
    class User extends Model{   
     /**
     * 将查询作用域限制为仅包含给定类型的用户。
     *
     * @param  \Illuminate\Database\Eloquent\Builder $query
     * @param  mixed $type
     * @return \Illuminate\Database\Eloquent\Builder
     */   
    public function scopeOfType($query, $type)  
      {      
        return $query->where('type', $type);   
       }
      }

$users = App\User::ofType('admin')->get();

is メソッドを使用すると、2 つのモデルに同じ主キー、テーブル、データベース接続があるかどうかを簡単に検証できます。 ##

イベント

Eloquent モデルはいくつかのイベントをトリガーし、モデルのライフ サイクルの次のノードに接続できるようにします: retrieved、creating、作成, 更新, 更新, 保存, 保存, 削除, 削除 、 restoreing および restored。イベントを使用すると、特定のモデルがデータベースに保存または更新されるたびにコードを実行できます。各イベントは、コンストラクターを通じてモデル インスタンスを受け取ります。

retrieved イベントは、既存のモデルがデータベースからデータを検索するときに発生します。新しいモデルが保存されるたびに、creating および created イベントが発生します。モデルがデータベースにすでに存在し、save メソッドが呼び出された場合、updating / updated イベントがトリガーされます。このような場合、 Saving / saved イベントもトリガーされます。

{note} Eloquent を通じてバッチ更新を実行する場合、更新されたモデルの saved および updated イベントはトリガーされません。これは、バッチ更新中にモデルが実際に取得されないためです。

まず、Eloquent モデルで $dispatchesEvents 属性を定義して、Eloquent モデルのライフサイクルのいくつかのノードを独自のイベント クラスにマップします:

if ($post->is($anotherPost)) { 
   //
 }

After Eloquent イベントを定義およびマッピングすると、イベント リスナーを使用してこれらのイベントを処理できます。

<?php
    namespace App;
    use App\Events\UserSaved;
    use App\Events\UserDeleted;
    use Illuminate\Notifications\Notifiable;
    use Illuminate\Foundation\Auth\User as Authenticatable;
    class User extends Authenticatable{  
      use Notifiable;   
       /**
     * 为模型事件。
     *
     * @var array
     */ 
      protected $dispatchesEvents = [    
          'saved' => UserSaved::class,        
          'deleted' => UserDeleted::class,   
           ];
       }

php artisan make:observer UserObserver --model=User

<?php
    namespace App\Observers;
    use App\User;
    class UserObserver{   
     /**
     * 处理 User 「新建」事件。
     *
     * @param  \App\User  $user
     * @return void
     */   
      public function created(User $user) 
         {      
           //  
          }   
     /**
     * 处理 User 「更新」 事件。
     *
     * @param  \App\User  $user
     * @return void
     */   
      public function updated(User $user)  
        {      
          //   
         }   
     /**
     * 处理 User 「删除」 事件。
     *
     * @param  \App\User  $user
     * @return void
     */   
     public function deleted(User $user) 
        {   
             //   
         }
   }