Метод first

Метод first применяется к запросу Eloquent или Query Builder и возвращает первый объект модели или коллекцию, соответствующую условиям запроса. Если запрос не находит ни одной записи, метод возвращает null. Метод автоматически добавляет ограничение LIMIT 1 к сгенерированному SQL-запросу.

Синтаксис

<?php
	Model::first();
	Model::where('column', $value)->first();
?>

Пример

Давайте получим первую запись из таблицы статей:

<?php
	use App\Models\Article;
	
	$article = Article::first();
	
	echo $article->title;
	echo $article->text;
?>

Результат выполнения кода:

"article 1"
"article text 1"

Пример

Давайте получим первую статью с определённым статусом:

<?php
	use App\Models\Article;
	
	$article = Article::where('status', 'published')->first();
	
	if ($article) {
		echo $article->title;
	} else {
		echo "No published articles found";
	}
?>

Результат выполнения кода:

"article 2"

Пример

Давайте получим первую статью, отсортированную по дате создания в порядке убывания:

<?php
	use App\Models\Article;
	
	$article = Article::orderBy('created_at', 'desc')->first();
	
	echo $article->title;
	echo $article->created_at;
?>

Результат выполнения кода:

"article 5"
"2026-09-07 15:30:00"

Пример

Давайте обработаем ситуацию, когда запись не найдена:

<?php
	use App\Models\Article;
	
	$article = Article::where('id', 999)->first();
	
	if ($article === null) {
		echo "Article not found";
	}
?>

Результат выполнения кода:

"Article not found"

Смотрите также

метод firstWhere,
который находит первый элемент по условию в коллекции
метод last,
который возвращает последний элемент коллекции
метод get,
который выполняет запрос и возвращает коллекцию всех записей
метод first из класса Arr,
который возвращает первый элемент массива