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 chaîne de caractères soit un entier positif // value peut être n'importe quoi

Exemple 11-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 soit une chaîne de caractères. 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'). Il n'y a aucune différence entre les tableaux indexés et les tableaux associatifs en PHP ; il n'y a qu'un type array, qui peut contenir soit des entiers, soit des chaînes en guise d'index.

Une valeur de tableau peut être de n'importe quel type.

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

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 11-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 entier de valeur 1. Utiliser FALSE comme clé revient à utiliser le type entier de valeur 0. Utiliser NULL comme clé revient à utiliser le type chaîne de caractères 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 de caractères, 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 11-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 ?

Vous devez toujours utiliser les guillemets autour de la chaîne de caractères placée en tant qu'index du tableau. Par exemple, utilisez $foo['bar'] et non pas $foo[bar]. Mais, pourquoi $foo[bar] est faux ? Vous pourriez avoir vu la syntaxe suivante en vos vieux scripts :

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

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. En fait, cela fonctionne car la constante indéfinie est transformée en chaîne ayant la même valeur.

D'autres exemples :

Exemple 11-28. Exemples de conflits de constantes indéfinies <?php // Affichons toutes les erreurs error_reporting(E_ALL); $arr = array('fruit' => 'pomme', 'legume' => 'carotte'); // Correct print $arr['fruit'];  // pomme print $arr['legume']; // 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 'legume'. define('fruit','legume'); // 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 11-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 11-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 informelle'; ?>

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

Exemple 11-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.