PHP isset(): проверка переменной и ключа массива

isset($var) возвращает true, если переменная существует и её значение не null. Для неопределённой переменной, удалённой через unset или хранящей null, она возвращает false и никогда не печатает предупреждений.

<?php
$name = "Ada";
$age = 0;
$nickname = null;

var_dump(isset($name));       // exists, not null
var_dump(isset($age));        // 0 is still set
var_dump(isset($nickname));   // null counts as not set
var_dump(isset($undefined));  // never assigned

unset($name);
var_dump(isset($name));       // removed with unset()

isset() смотрит только на то, есть ли что-то на месте. Значение, которое задано, но пусто, например 0, "" или [], всё равно даёт true. Если нужно "задано и не пусто", используйте empty с отрицанием.

Проверка ключа массива через isset

Чаще всего isset() используют именно так. Чтение несуществующего ключа в обычной конфигурации PHP печатает Warning: Undefined array key; предварительная проверка через isset() этого не делает. Она работает и для вложенных ключей и тихо останавливается на первом отсутствующем уровне.

<?php
$user = [
    "name" => "Grace",
    "email" => "grace@example.com",
    "address" => ["city" => "Arlington"],
    "phone" => null,
];

var_dump(isset($user["email"]));
var_dump(isset($user["website"]));
var_dump(isset($user["address"]["city"]));
var_dump(isset($user["address"]["zip"]));
var_dump(isset($user["company"]["name"]));  // parent key missing too
var_dump(isset($user["phone"]));            // key exists, value is null

if (isset($user["email"])) {
    echo "Send mail to {$user['email']}\n";
}

Когда нужно только значение или значение по умолчанию, $user["website"] ?? "none" делает ту же проверку за один шаг. Смотрите оператор объединения с null.

isset с несколькими переменными

Передайте несколько аргументов, и isset() вернёт true, только если все они заданы и не равны null. Это короткий способ убедиться, что пришли все обязательные поля.

<?php
$data = ["first" => "Ada", "last" => "Lovelace", "email" => null];

var_dump(isset($data["first"], $data["last"]));
var_dump(isset($data["first"], $data["email"]));

$required = ["first", "last", "email"];
$missing = array_filter($required, fn($key) => !isset($data[$key]));
echo "Missing: " . implode(", ", $missing) . "\n";

isset для строк и объектов

Для строки isset($str[5]) проверяет, есть ли символ на позиции 5, это быстрая проверка длины. Для объекта проверяется свойство; если у класса с закрытыми данными определён метод __isset(), isset() вызывает его.

<?php
$code = "AB12";
var_dump(isset($code[3]));   // 4th character exists
var_dump(isset($code[4]));   // there is no 5th

class Profile
{
    public ?string $bio = null;
    public string $name = "Linus";
    private array $extra = ["twitter" => "@linus"];

    public function __isset(string $key): bool
    {
        return isset($this->extra[$key]);
    }
}

$p = new Profile();
var_dump(isset($p->name));
var_dump(isset($p->bio));       // null
var_dump(isset($p->twitter));   // answered by __isset()
var_dump(isset($p->github));

isset, empty и is_null

Выберите значение $x в таблице, чтобы сравнить три проверки и простое приведение (bool). Каждую ячейку вычислил PHP 8.3.

Что стоит запомнить:

• isset() даёт false только для null и того, чего не существует.
• empty() даёт true для этого же и ещё для любого ложного значения: false, 0, 0.0, "", "0", [].
• is_null() для существующих переменных даёт противоположное isset(), но предупреждает, когда переменная не определена. Вместо неё используйте isset() или === null.

Проверка отправки формы

isset() это классический способ узнать, пришло ли поле формы. Запустите этот блок, введите имя и нажмите Send: тот же скрипт выполнится снова с заполненным $_POST.

<?php
$message = "";
if (isset($_POST["name"])) {
    $name = trim($_POST["name"]);
    $message = $name === ""
        ? "<p style='color:#c33'>Please type a name.</p>"
        : "<p>Hello, " . htmlspecialchars($name) . "</p>";
}
?>
<form method="post">
  <label>Name <input name="name"></label>
  <label><input type="checkbox" name="news" value="1"> Newsletter</label>
  <button>Send</button>
</form>
<?= $message ?>
<?php if (isset($_POST["name"])): ?>
  <p>Newsletter: <?= isset($_POST["news"]) ? "yes" : "no" ?></p>
<?php endif; ?>

Пустое текстовое поле всё равно отправляется, как "", поэтому после любой отправки isset($_POST["name"]) даёт true. Неотмеченный чекбокс не отправляется вовсе, поэтому для чекбоксов isset() ровно то, что нужно. Чтобы требовать непустое значение, проверяйте строку после trim, как в этом блоке. На странице о формах собрана полная форма с проверкой.

isset и array_key_exists

Они совпадают во всём, кроме ключа со значением null. isset() считает его отсутствующим, array_key_exists() нет.

<?php
$settings = ["timeout" => 30, "proxy" => null];

foreach (["timeout", "proxy", "retries"] as $key) {
    printf("%-8s isset: %-5s  array_key_exists: %s\n",
        $key,
        var_export(isset($settings[$key]), true),
        var_export(array_key_exists($key, $settings), true));
}

Если в ваших данных "задано как null" значит не то же самое, что "не настроено", используйте array_key_exists(). В остальных случаях isset() короче, а поскольку это языковая конструкция, а не вызов функции, ещё и немного быстрее.

Частая ошибка: isset для выражения

isset() принимает только переменные, элементы массивов и свойства. Передача результата функции или константы вызывает ошибку компиляции:

<?php
if (isset(trim($input))) {}

PHP Fatal error:  Cannot use isset() on the result of an expression (you can use "null !== expression" instead) in /home/index.php on line 2

Сначала сохраните результат в переменную или проверяйте само значение: null !== $expr, как предлагает сообщение, или trim($input) !== "" для строки.