Метод whereNull

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

Синтаксис

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

Пример

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

<?php
	use AppModelsArticle;
	
	$res = Article::whereNull('description')->get();
	
	foreach ($res as $article) {
		echo $article->title;
	}
?>

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

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

Пример

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

<?php
	use AppModelsUser;
	
	$res = User::whereNull('phone')->get();
	
	foreach ($res as $user) {
		echo $user->name;
	}
?>

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

"John Doe"
"Jane Smith"
"Bob Johnson"

Пример

Давайте объединим условие whereNull с другим условием для более точной фильтрации. Найдём статьи, у которых поле 'description' равно NULL и статус равен 'draft':

<?php
	use AppModelsArticle;
	
	$res = Article::whereNull('description')
		->where('status', 'draft')
		->get();
	
	foreach ($res as $article) {
		echo $article->title;
	}
?>

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

"Draft Article 1"
"Draft Article 2"

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

метод whereNotNull,
который выбирает записи с заполненным полем
метод where,
который фильтрует записи по заданным условиям
метод orWhereNull,
который добавляет условие NULL через ИЛИ
метод get,
который выполняет запрос и возвращает коллекцию