Метод firstWhere

Метод firstWhere применяется к запросу Eloquent или Query Builder и возвращает первую найденную модель или коллекцию. Если записей, удовлетворяющих условию, нет, метод возвращает null. Первым параметром передаётся имя колонки, вторым - оператор сравнения, третьим - значение. Если оператор не указан, используется равенство.

Синтаксис

<?php
	Model::firstWhere($column, $operator, $value);
?>

Пример

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

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

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

"article 1"

Пример

Давайте найдём первую статью с 'id' больше 5:

<?php
	use AppModelsArticle;
	
	$article = Article::firstWhere('id', '>', 5);
	
	if ($article) {
		echo $article->title;
	} else {
		echo "No articles found";
	}
?>

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

"article 6"

Пример

Давайте найдём первую статью с 'views' равным 100:

<?php
	use AppModelsArticle;
	
	$article = Article::firstWhere('views', 100);
	
	if ($article) {
		echo $article->title;
	} else {
		echo "No articles found";
	}
?>

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

"article 3"

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

метод first,
который получает первую запись без условий
метод firstOrFail,
который выбрасывает исключение, если запись не найдена
метод find,
который ищет запись по первичному ключу
метод where,
который фильтрует записи по заданным условиям