Метод whereNull

Метод whereNull применяется к запросу Eloquent или Query Builder и возвращает тот же запрос, дополненный условием выборки. Первым параметром передаётся имя колонки, для которой необходимо проверить наличие значения NULL.

Синтаксис

<?php
	Model::whereNull($column);
?>

Пример

Давайте выберем все статьи, у которых поле 'deleted_at' равно NULL (не удалённые):

<?php
	use AppModelsArticle;

	$articles = Article::whereNull('deleted_at')->get();

	foreach ($articles as $article) {
		echo $article->title;
	}
?>

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

"article 1"
"article 2"
"article 3"

Пример

Давайте выберем пользователей, у которых 'phone' равно NULL (не указан номер телефона):

<?php
	use AppModelsUser;

	$users = User::whereNull('phone')->get();

	foreach ($users as $user) {
		echo $user->name;
	}
?>

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

"user 1"
"user 3"

Пример

Метод whereNull можно комбинировать с другими условиями выборки. Давайте выберем статьи, у которых поле 'deleted_at' равно NULL и 'status' равно 'published':

<?php
	use AppModelsArticle;

	$articles = Article::whereNull('deleted_at')
		->where('status', 'published')
		->get();

	foreach ($articles as $article) {
		echo $article->title;
	}
?>

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

"article 1"
"article 3"

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

метод whereNotNull,
который выбирает записи с непустым полем
метод where,
который фильтрует записи по заданным условиям
метод whereIn,
который фильтрует по списку значений
метод orWhere,
который добавляет условие через ИЛИ