isset() ב-PHP: בדיקה אם משתנה או מפתח מערך מוגדרים

isset($var) מחזירה true אם המשתנה קיים והערך שלו אינו null. היא מחזירה false למשתנה לא מוגדר, למשתנה שעבר unset או למשתנה שמחזיק null, והיא אף פעם לא מדפיסה אזהרה.

<?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() הכי הרבה. קריאה של מפתח שלא קיים מדפיסה Warning: Undefined array key בהתקנת PHP רגילה; בדיקה קודם עם 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 coalescing.

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) !== "" למחרוזת.