UUIDs-In-Laravel-Part-3.php

/**
 * Scope a query to only include models matching the supplied UUID.
 * Returns the model by default, or supply a second flag `false` to get the Query Builder instance.
 *
 * @throws \Illuminate\Database\Eloquent\ModelNotFoundException
 *
 * @param  \Illuminate\Database\Schema\Builder $query The Query Builder instance.
 * @param  string                              $uuid  The UUID of the model.
 * @param  bool|true                           $first Returns the model by default, or set to `false` to chain for query builder.
 * @return \Illuminate\Database\Eloquent\Model|\Illuminate\Database\Eloquent\Builder
 */
public function scopeUuid($query, $uuid, $first = true)
{
    if (!is_string($uuid) || (preg_match('/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/', $uuid) !== 1)) {
        throw (new ModelNotFoundException)->setModel(get_class($this));
    }

    $search = $query->where('uuid', $uuid);

    return $first ? $search->firstOrFail() : $search;
}