Laravel Eloquent для начинающих

После установки Laravel у вас по умолчанию есть три миграции: одна миграция для таблицы users , одна для password_resets и одна для failed_jobs. (Последнее предназначено для очередей в Laravel. Это расширенная функция, и в нее уже не нужно углубляться.)

Это миграция, которая создает таблицу пользователей, с несколькими комментариями с моей стороны:

<?php
 
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
 
class CreateUsersTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('users', function (Blueprint $table) {
            $table->id();
            $table->string('name'); 
            $table->string('email')->unique();
            $table->timestamp('email_verified_at')->nullable();
            $table->string('password');
            $table->rememberToken(); 
            $table->timestamps();
        });
    }
 
    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('users');
    }
}

Теперь запустите одну из следующих команд, чтобы запустить миграцию:

php artisan migrate

• Модель "Post" становится именем таблицы "posts"
• Модель "UserPost" становится именем таблицы "user_posts"
• Модель "EmailSubscriber" становится именем таблицы "email_subscribers"

Это чисто условность. Помните: имя модели Eloquent всегда в единственном числе , и если оно состоит из нескольких слов, слова разделяются заглавной буквой ( UserPost). Имя таблицы всегда во множественном числе и имеет вид «snake_cased» ( user_posts). Помните об этом соглашении, потому что оно может помочь вам позже.

Несколько примеров, в users таблице есть User модель. В categories таблице есть Catagory модель. В user_categories таблице есть UserCategory модель.

В любом случае, если имя вашей таблицы отличается от того, что предполагает соглашение, вы можете добавить в свой класс следующее:

protected $table = 'my_posts';

Основной ключ

По умолчанию Eloquent предполагает, что каждая таблица имеет первичное автоинкрементное целое число с именем id. Если ваша миграция содержит это (по умолчанию):

$table->id();

Тогда всё в порядке. Если нет, вы можете установить другой ключ в качестве первичного ключа :

protected $primaryKey = 'post_id';

Временные метки

По умолчанию Eloquent предполагает, что каждая таблица имеет столбец created_at и updated_at Если ваша миграция содержит это (по умолчанию):

$table->timestamps();

Если нет, сообщите Eloquent, что вы не используете временные метки:

public $timestamps = false;

Получение данных из модели Eloquent

Получение нескольких строк из Eloquent

Давайте теперь посмотрим, как мы используем Eloquent и получаем от него данные. Во-первых, давайте соберем все предметы . Есть два способа сделать это:

use App\Models\User;
 
$users = User::all();
$users = User::get(); // Just as valid, this means exactly the same
 
foreach ($users as $user) {
    echo $user->name;
}

Фильтруем результаты

$admins = User::where('admin', true)->get();
 
foreach ($admins as $admin) {
   echo $admin->email;
}

// Пользователи, созданные более чем 7 дней назад
$admins = User::where('created_at', '<', now()->subDays(7))->get();

$user = User::find(2); // получить пользователя с id=2

$user = User::where('admin', true)->first();

$oldest_comment = Comment::orderBy('created_at', 'asc')->first;
$newest_pos .= Post::latest()->first();

$user = User::findOrFail(2);
$user = User::where('admin', true)->firstOrFail();

Illuminate\Database\Eloquent\ModelNotFoundException

try {
   $user = User::findOrFail(2);
   $user = User::where('admin', true)->firstOrFail();
} catch (\Illuminate\Database\Eloquent\ModelNotFoundException $e) {
   return redirect('/');
}

$post = new Post;
$post->title = 'Заголовок статьи';
$post->content = 'Содержание статьи';
$post->author_id = auth()->user()->id; 

 
$post->save();

$post = Post::make([
   'title' => 'Заголовок статьи',
    'content' => 'Содержание статьи',
    'author_id' => auth()->user()->id,
]);

$post->save();

$post = Post::create([
   'title' => 'Заголовок статьи',
    'content' => 'Содержание статьи',
    'author_id' => auth()->user()->id,
]);

$post = Post::update($request->all());

protected $fillable = [ 'title', 'content' ];

protected $guarded = [ 'author_id' ];

protected $guarded = [];

$table->foreignId('user_id');
 
// или
 
$table->foreignIdFor(User::class);

public function membership(): HasOne
{
    return $this->hasOne(Membership::class);
}

public function user(): BelongsTo
{
    return $this->belongsTo(User::class);
}

$user = User::find(1);
 
$membership = $user->membership = 'Unique membership title';
$membership->save();

$user = Membership::find(1)->user;
 
$name = $user->name;

// User model
public function posts(): HasMany
{
    return $this->hasMany(Post::class);
}

public function user(): BelongsTo
{
    return $this->belongsTo(User::class);
}