unset

    (PHP 4, PHP 5, PHP 7, PHP 8)

    unset — Détruit une variable

    Description

    unset(mixed$var, mixed...$vars): void

    unset() détruit la ou les variables dont le nom a été passé en argument var.

    Le comportement de unset() à l'intérieur d'une fonction peut varier suivant le type de variable que vous voulez détruire.

    Si une variable globale est détruite avec unset() depuis une fonction, seule la variable locale sera détruite. La variable globale gardera la valeur acquise avant l'appel à unset().

    <?php
    function destroy_foo()
    {
    global     $foo;
    unset(    $foo);
    }

    $foo = 'bar';
    destroy_foo();
    echo     $foo;
    ?>

    L'exemple ci-dessus va afficher :

    bar

    Pour détruire une variable globale à l'intérieur d'une fonction, vous pouvez utiliser le tableau $GLOBALS :

    <?php
    function foo()
    {
    unset(    $GLOBALS['bar']);
    }

    $bar = "truc";
    foo();
    ?>

    Si une variable qui est passée par référence est détruite à l'intérieur d'une fonction, seule la variable locale sera détruite. La variable globale conservera la même valeur qu'elle avait avant l'appel de unset().

    <?php
    function foo(&$bar)
    {
    unset(    $bar);
    $bar = "blah";
    }

    $bar = 'truc';
    echo     "$bar\n";

    foo($bar);
    echo     "$bar\n";
    ?>

    L'exemple ci-dessus va afficher :

    truc truc

    Si une variable statique est détruite à l'intérieur d'une fonction unset() détruira la variable seulement dans le contexte du reste de la fonction. Les appels suivants restaureront la valeur précédente de la variable.

    <?php
    function foo()
    {
    static     $bar;
    $bar++;
    echo     "Avant unset : $bar, ";
    unset(    $bar);
    $bar = 23;
    echo     "après unset : $bar\n";
    }

    foo();
    foo();
    foo();
    ?>

    L'exemple ci-dessus va afficher :

    Avant unset : 1, après unset: 23 Avant unset : 2, après unset: 23 Avant unset : 3, après unset: 23

    Liste de paramètres

    var

    La variable à détruire.

    vars

    Variables supplémentaires.

    Valeurs de retour

    Aucune valeur n'est retournée.

    Exemples

    Exemple #1 Exemple avec unset()

    <?php
    // Destruction d'une seule variable
    unset($foo);

    // Destruction d'un élément de tableau
    unset($bar['quux']);

    // Destruction de plusieurs variables
    unset($foo1, $foo2, $foo3);
    ?>

    Exemple #2 Exemple avec un transtypage (unset)

    Le transtypage (unset) est souvent confondu avec la fonction unset(). Le transtypage (unset) sert uniquement à transtyper en type NULL. Il n'altère pas la variable transtypée. Le transtypage (unset) est obsolète à partir de PHP 7.2.0 et supprimé à partir de 8.0.0.

    <?php
    $name     = 'Felipe';

    var_dump((unset) $name);
    var_dump($name);
    ?>

    L'exemple ci-dessus va afficher :

    NULL string(6) "Felipe"

    Notes

    Note: Comme ceci est une structure du langage, et non pas une fonction, il n'est pas possible de l'appeler avec les fonctions variables ou arguments nommés.

    Note:

    Il est possible de détruire n'importe quelle propriété visible dans le contexte courant.

    Si déclaré, __get() est appelé lors de l'accès à une propriété non définie, et __set() est appelé lors de la définition d'une propriété non définie.

    Note:

    Il n'est pas possible de détruire la variable spéciale $this à l'intérieur d'une méthode d'un objet.

    Note:

    Lors de l'utilisation de cette fonction sur des propriétés d'objet inaccessibles, la méthode magique __unset sera appelée, si elle existe.

    Voir aussi

    To Top