Метод first

Метод first применяется к запросу Eloquent или Query Builder, выполняет запрос и возвращает первую запись из результата. Если запись не найдена, возвращается null. В отличие от метода get, который возвращает коллекцию всех записей, метод first возвращает одну модель или объект. Метод не принимает параметров, но может быть вызван после любых условий и сортировок.

Синтаксис

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

Пример

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

<?php
	use AppModelsArticle;
	
	$article = Article::first();
	echo $article->title;
?>

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

"First article"

Пример

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

<?php
	use AppModelsArticle;
	
	$article = Article::where('status', 'published')->first();
	echo $article->title;
?>

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

"Published article 1"

Пример

Давайте получим самую свежую статью с помощью сортировки:

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

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

"Latest article"

Пример

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

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

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

"Article not found"

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

метод get,
который возвращает коллекцию всех записей
метод firstOrFail,
который выбрасывает исключение при отсутствии записи
метод sole,
который возвращает единственную запись или исключение
метод find,
который находит запись по первичному ключу