PHP isset(): czy zmienna lub klucz tablicy jest ustawiony

isset($var) zwraca true, jeśli zmienna istnieje, a jej wartość nie jest null. Zwraca false dla niezdefiniowanej zmiennej, zmiennej usuniętej przez unset albo przechowującej null i nigdy nie wypisuje ostrzeżenia.

<?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() sprawdza tylko, czy coś jest. Wartość ustawiona, ale pusta, jak 0, "" albo [], nadal daje true. Jeśli chcesz „ustawione i niepuste”, użyj empty (z negacją).

Sprawdzanie klucza tablicy przez isset

Tu isset() używa się najczęściej. Odczyt nieistniejącego klucza wypisuje w zwykłej konfiguracji PHP Warning: Undefined array key; wcześniejsze sprawdzenie przez isset() nie. Działa też dla zagnieżdżonych kluczy i po cichu zatrzymuje się na pierwszym brakującym poziomie.

<?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";
}

Gdy potrzebujesz tylko wartości albo wartości domyślnej, $user["website"] ?? "none" wykonuje to samo sprawdzenie w jednym kroku. Zobacz operator null coalescing.

isset z wieloma zmiennymi

Przekaż kilka argumentów, a isset() zwróci true tylko wtedy, gdy wszystkie są ustawione i nie są null. To krótki sposób sprawdzenia, czy dotarło każde wymagane pole.

<?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 na łańcuchach i obiektach

Na łańcuchu isset($str[5]) sprawdza, czy pod przesunięciem 5 jest znak, co jest szybkim sprawdzeniem długości. Na obiekcie sprawdza właściwość; w klasie z prywatnymi danymi isset() wywołuje metodę __isset(), jeśli klasa ją definiuje.

<?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 vs empty vs is_null

Wybierz w tabeli wartość $x, aby porównać trzy sprawdzenia i zwykłe rzutowanie (bool). Każdą komórkę obliczyło PHP 8.3.

Wzorzec do zapamiętania:

• isset() daje false tylko dla null i rzeczy, które nie istnieją.
• empty() daje true dla nich i dodatkowo dla każdej wartości fałszywej: false, 0, 0.0, "", "0", [].
• is_null() dla istniejących zmiennych daje odwrotność isset(), ale ostrzega, gdy zmienna jest niezdefiniowana. Zamiast niego użyj isset() albo === null.

Sprawdzanie, czy formularz został wysłany

isset() to klasyczny sposób sprawdzenia, czy pole formularza dotarło. Uruchom ten blok, wpisz imię i kliknij Send: ten sam skrypt wykona się ponownie z wypełnionym $_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; ?>

Puste pole tekstowe też jest wysyłane, jako "", więc isset($_POST["name"]) daje true po każdym wysłaniu. Niezaznaczony checkbox nie jest wysyłany wcale, dlatego isset() to dokładnie właściwy test dla checkboxów. Aby wymagać niepustej wartości, sprawdź łańcuch po przycięciu, jak robi to blok. Strona o formularzach buduje pełny formularz z walidacją.

isset vs array_key_exists

Te dwie funkcje zgadzają się we wszystkim poza kluczem o wartości null. isset() traktuje go jak brakujący, array_key_exists() nie.

<?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));
}

Jeśli w Twoich danych „ustawione na null” znaczy co innego niż „nieskonfigurowane”, użyj array_key_exists(). W przeciwnym razie isset() jest krótsze, a jako konstrukcja językowa, a nie wywołanie funkcji, jest też nieco szybsze.

Częsty błąd: isset na wyrażeniu

isset() przyjmuje tylko zmienne, elementy tablic i właściwości. Przekazanie wyniku funkcji albo stałej to błąd kompilacji:

<?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

Najpierw zapisz wynik w zmiennej albo sprawdź samą wartość: null !== $expr, jak sugeruje komunikat, albo trim($input) !== "" dla łańcucha.