Les tableaux

Créer un tableau array()

Un tableau array peut être créé avec la fonction array(). Cette fonction prend en argument des structures key => value, séparées par des virgules.

array( [key =>] value , ... ) // key est soit une string soit un integer positif // value peut être n'importe quoi

Exemple 10-20. Affectations de tableaux <?php $arr = array("foo" => "bar", 12 => true); echo $arr["foo"]; // bar echo $arr[12];    // 1 ?>

Une clé key est soit un entier ou bien une chaîne. Si une clé est la représentation standard d'un entier positif, elle sera interprétée comme tel. (i.e. '8' sera interprété comme 8, tandis que '08' sera interprèté comme '08').

Une valeur de tableau peut être n'importe quoi.

Exemple 10-21. Création d'un tableau associatif <?php array("untableau" => array(6 => 5, 13 => 9, "a" => 43)); echo $arr["untableau"][6];    // 5 echo $arr["untableau"][13];   // 9 echo $arr["untableau"]["a"];  // 43    ?>

Si vous omettez une clé lors de la spécification d'un tableau, l'indice maximum + 1 sera utilisé comme clé par défaut. Si aucun indice numérique n'a été généré, ce sera 0. Si vous en spécifiez une qui a déjà été assignée, la nouvelle valeur écrasera la précédente.

Exemple 10-22. Indexation automatique de tableau <?php // Ce tableau est identique à array(5 => 43, 32, 56, "b" => 12); // Celui ci array(5 => 43, 6 => 32, 7 => 56, "b" => 12); ?>

Utiliser TRUE comme clé revient à utiliser le type integer de valeur 1. Utiliser FALSE comme clé revient à utiliser le type integer de valeur 0. Utiliser NULL comme clé revient à utiliser le type string de valeur "". Utiliser la chaîne vide comme index va créer cet index, et ce n'est pas la même chose que d'utiliser des crochets vides.

Il n'est pas possible d'utiliser des tableaux ou des objets comme clés. Ce faisant, vous généreriez une alerte : Illegal offset type.

La syntaxe à crochets

Vous pouvez aussi modifier un tableau existant en lui assignant simplement des valeurs.

L'assignation de valeurs de tableau se fait en spécifiant la clé entre crochets. Si vous omettez la clé ("$tableau[]"), la valeur sera ajoutée à la fin du tableau.

$arr[key] = value; $arr[] = value; // key est soit une chaîne, soit un entier // value peut être n'importe quoi

Si $arr n'existe pas, il sera créé. Cela en fait une alternative pour créer un tableau. Pour modifier une valeur, assignez-lui une nouvelle valeur. Pour supprimer une valeur, utilisez la fonction unset().

Exemple 10-23. Manipuler des éléments de tableau <?php $arr = array(5 => 1, 12 => 2); $arr[] = 56;    // Ceci revient à $arr[13] = 56;                 // à ce moment du script $arr["x"] = 42; // Ceci ajoute un nouvel élément                 // avec l'index "x"                  unset($arr[5]); // Ceci efface un élément du tableau unset($arr);    // Ceci efface tout le tableau ?>

Pourquoi est-ce que $foo[bar] est invalide?

Dans vos vieux scripts, vous pouvez avoir utilisé la syntaxe suivante :

Exemple 10-26. Accès aux index de tableaux, ancienne méthode <?php $foo[bar] = 'ennemi'; echo $foo[bar]; ?>

Cela est mauvais, mais ca marche. Pourquoi est-ce mauvais? La raison est que PHP attend une constante entre crochets (bar) plutôt qu'une chaîne ('bar', notez les guillemets). Or, PHP pourrait définir dans le futur des constantes qui, malheureusement pour votre code, auront ce nom. Actuellement, cela fonctionne car la constante indéfinie est transformée en chaîne ayant la même valeur.

D'autres exemples :

Exemple 10-28. Exemples de conflits de constantes indéfinies <?php // Affichons toutes les erreurs error_reporting(E_ALL); $arr = array('fruit' => 'pomme', 'légume' => 'carotte'); // Correct print $arr['fruit'];  // pomme print $arr['légume']; // carotte // Incorrect.  Cela fonctionne mais PHP affiche une alerte car // il y a utilisation d'une constante indéfinie appelée fruit // // Notice: Use of undefined constant fruit - assumed 'fruit' in... print $arr[fruit];    // pomme // Définissons une constante pour illustrer le problème. // Nous créons une constante appelée fruit, qui vaut 'légume'. define('fruit','légume'); // Notez la différence print $arr['fruit'];  // pomme print $arr[fruit];    // carotte // La suite est correcte si cela se passe dans une chaîne. // Les constantes ne sont pas remplacées par leur valeur dans une chaîne print "Bonjour $arr[fruit]";      // Bonjour pomme // A une exception, les accolades entourant un tableau dans une chaîne // permettent d'utiliser les constantes print "Bonjour {$arr[fruit]}";    // Bonjour carotte print "Bonjour {$arr['fruit']}";  // Bonjour pomme // Ceci ne fonctionnera pas, et donnera une erreur d'analyse // Parse error: parse error, expecting T_STRING' or T_VARIABLE' or T_NUM_STRING' // Cela s'applique aussi aux autoglobales dans les chaînes print "Bonjour $arr['fruit']"; print "Bonjour $_GET['foo']"; // La concatenation est une alternative print "Bonjour " . $arr['fruit']; // Bonjour pomme ?>

Lorsque vous activez l'error_reporting() pour afficher les erreurs de niveau E_NOTICE (en utilisant le niveau E_ALL) alors, vous verrez ces erreurs. Par défaut, error_reporting est trop faible pour les afficher.

Comme indiqué dans la section syntaxe, il doit y avoir une expression entre les crochets ('[' et ']'). Cela signifie que vous pouvez écrire ceci :

Exemple 10-29. Utilisation d'une expression dans un index de tableau <?php echo $arr[somefunc($bar)]; ?>

Ceci est un exemple d'utilisation de retour de fonction comme index de tableau. PHP reconnaît aussi les constantes, comme la famille des E_*.

Exemple 10-30. Utilisation d'une constante dans un index de tableau <?php $error_descriptions[E_ERROR]   = 'Une erreur fatale est survenue'; $error_descriptions[E_WARNING] = 'PHP émet une alerte'; $error_descriptions[E_NOTICE]  = 'Ceci est juste une alerte informationnelle'; ?>

Notez que E_ERROR est aussi un identifiant valide, tout comme bar dans le premier exemple. Mais le dernier exemple est identique à ceci :

Exemple 10-31. Utilisation d'une constante dans un index de tableau(2) <?php $error_descriptions[1] = 'Une erreur fatale est survenue'; $error_descriptions[2] = 'PHP émet une alerte'; $error_descriptions[8] = 'Ceci est juste une alerte informationnelle'; ?>

car E_ERROR vaut 1, etc.

Comme nous l'avons déjà expliqué dans les exemples ci-dessus, $foo[bar] fonctionne mais est dangereux. Cela fonctionne car bar est identifié comme une constante. Mais, si la constante n'existe pas, PHP suppose que vous souhaitez utiliser bar littéralement, sous la forme "bar", mais que vous avez oublié les guillemets.