Manuel PHP
Précédent | Chapitre 6. Les types | Suivant

# Les tableaux

Un tableau `PHP` est en fait une association ordonnée (littéralement, une `map`). Une association est un type qui fait correspondre des valeurs à des clés. Ce type est optimisé de diverses façons, qui font que vous pouvez le manipuler comme un tableau à indices réels, une liste (vecteur), ou un table de hachage (qui est une implémentation d'association), dictionnaire, collection, pile, queue et encore d'autres. Comme une valeur peut elle-même être un tableau, vous pouvez simuler facilement un arbre.

Les détails d'implémentation de ces structures sont hors du champs de ce manuel, mais vous trouverez ici un exemple de toutes ces structures.

## Syntaxe

### 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 6-19. 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 6-20. 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 6-21. 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 6-22. 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 ?>`

> Note : Comme indiqué ci-dessus, si vous fournissez des crochets sans spécifier de clé, le plus grand index existant et entier est recherché, et la nouvelle clé générée est cette valeur maximum + 1. Si aucune clé entière n'exist, la valeur sera alors `0`. Si vous spécifiez une clé qui est déjà existante, vous écraserez le contenu précédent.

> Avertissement
> Depuis `PHP` 4.3.0, la génération d'index a changé. Si vous ajoutez un élément et que la valeur maximale de la clé est négative, alors la prochaine clé générée est `0`. Auparavant, c'était la plus grande valeur + 1, négative ou pas. Cela reste le comportement pour les clés positives.

> Notez que le maximum théorique n'a pas besoin d'exister au moment de la génération. Il peut simplement avoir existé auparavant.

> Exemple 6-23. La génération automatique de clé peut utiliser un ancien maximum

> `<?php
> // Crée un simple tableau
> $array = array(1, 2, 3, 4, 5);
> print_r($array);
> // On efface tous les éléments, mais on laisse le tableau
> foreach ($array as $i => $value) {
> unset($array[$i]);
> }
> print_r($array);
> // On ajoute une valeur : notez que la nouvelle clé est 5
> // et non pas 0, comme on l'attendrait.
> $array[] = 6;
> print_r($array);
> // Re-indexation :
> $array = array_values($array);
> $array[] = 7;
> print_r($array);
> ?>`

> L'exemple ci-dessus va afficher :

>     Array
>     (
>         [0] => 1
>         [1] => 2
>         [2] => 3
>         [3] => 4
>         [4] => 5
>     )
>     Array
>     (
>     )
>     Array
>     (
>         [5] => 6
>     )
>     Array
>     (
>         [0] => 6
>         [1] => 7
>     )

## Fonctions pratiques

Il y a toute une panoplie de fonctions pratiques pour travailler avec les tableaux.

> Note : La fonction unset() permet d'effacer des index dans un tableau. Sachez bien que le tableau ne sera PAS réindexé. Si vous utilisez uniquement des index numériques (commençant à zéro, et incrémentés de un), vous pouvez effectuer la réindexation en utilisant array_values().

> Exemple 6-24. Manipuler des éléments de tableau

> `<?php $a = array(1 => 'un', 2 => 'deux', 3 => 'trois'); unset($a[2]); /* Cela va produire un tableau qui aurait été $a = array(1 => 'un', 3 => 'trois'); et non pas $a = array(1 => 'un', 2 =>'trois'); */ $b = array_values($a); // Maintenant b est le tableau array(1 => 'un', 2 =>'trois') ?>`

L'élément de langage foreach est spécifiquement dédié aux tableaux : il permet de passer en revue simplement les valeurs d'un tableau.

## A faire et à ne pas faire avec les tableaux

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

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

Exemple 6-25. 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.

> Note : Cela ne signifie pas que vous devez toujours mettre les clés entre guillemets. Vous n'allez pas utiliser les guillemets avec les clés qui sont des constantes ou des variables, car cela empêchera `PHP` de les interprêter correctement.

> Exemple 6-26. Ne pas mettre les clés de tableaux entre guillemets

> `<?php error_reporting(E_ALL); ini_set('display_errors', true); ini_set('html_errors', false); // Tableau simple : $array = array(1, 2); $count = count($array); for ($i = 0; $i < $count; $i++) { echo "\nChecking $i : \n"; echo "Mauvais : " . $array['$i'] . "\n"; echo "Bon : " . $array[$i] . "\n"; echo "Mauvais : {$array['$i']}\n"; echo "Bon : {$array[$i]}\n"; } ?>`

> L'exemple ci-dessus va afficher :

>     Checking 0:

>     Notice: Undefined index:  $i in /Users/iboom/Desktop/CVS/docs/mysql/mysql.fr/- on line 10
>     Mauvais :
>     Bon : 1

>     Notice: Undefined index:  $i in /Users/iboom/Desktop/CVS/docs/mysql/mysql.fr/- on line 12
>     Mauvais :
>     Bon : 1

>     Checking 1:

>     Notice: Undefined index:  $i in /Users/iboom/Desktop/CVS/docs/mysql/mysql.fr/- on line 10
>     Mauvais :
>     Bon : 2

>     Notice: Undefined index:  $i in /Users/iboom/Desktop/CVS/docs/mysql/mysql.fr/- on line 12
>     Mauvais :
>     Bon : 2

D'autres exemples :

Exemple 6-27. 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 6-28. 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 6-29. 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 6-30. 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.

#### Pourquoi est-ce aussi dangereux?

A l'avenir, le groupe `PHP` peut décider d'ajouter une constante ou un autre mot clé, ou bien vous souhaiterez aussi ajouter une constante dans votre application, et vous serez bloqué. Par exemple, vous ne pouvez pas utiliser des mots comme `empty` et `default` de cette manière, car il sont déjà réservés.

> Note : Pour insister, à l'intérieur d'une chaîne de caractères (string) à guillemets doubles, il est correct de ne pas utiliser les guillemets simples dans les index, et `"$foo[bar]"` est valide. Voyez les exemples ci-dessus pour plus de détails sur la syntaxe des variables dans les chaînes.

## Conversion en tableau

Pour les types scalaires (integer, float, string, boolean et resource), convertir une valeur en tableau retourne un tableau qui contient un élément (à l'index 0) qui est la valeur originale.

Si vous convertissez un tableau en objet, vous obtiendrez des propriétés ou bien cet objet comme éléments de tableau. Les clés créées sont les noms des membres.

Si vous convertissez la valeur `NULL` en tableau, vous obtiendrez un tableau vide.

## Comparaisons de tableaux

Il est possible de comparer des tableaux grâce à la fonctoin array_diff() et aux opérateurs de tableaux.

## Exemples

Le type tableau de `PHP` est très souple. Voici quelques exemples d'utilisation :

Exemple 6-31. Utilisation des tableaux

`<?php
// ceci
$a = array( 'couleur' => 'rouge'
, 'gout' => 'sucre'
, 'forme' => 'rond'
, 'nom' => 'pomme'
, 4 // cette clé sera 0
);
// est complétement équivalent à
$a['couleur'] = 'rouge';
$a['gout'] = 'sucre';
$a['forme'] = 'rond';
$a['nom'] = 'pomme';
$a[] = 4; // cette clé sera 0
$b[] = 'a';
$b[] = 'b';
$b[] = 'c';
// va créer le tableau array( 0 => 'a' , 1 => 'b' , 2 => 'c' )
// ou plus simplement array('a' , 'b' , 'c' )
?>`

Exemple 6-32. Utilisation de array()

`<?php
// Array comme correspondance
$map = array( 'version' => 4
, 'OS' => 'Linux'
, 'langue' => 'français'
, 'short_tags' => TRUE );
// valeur strictement numériques
$array = array( 7
, 8
, 0
, 156
, -10
);
// ceci est la même chose que array( 0 => 7, 1 => 8, ...)
$switching = array( 10 // clé = 0
, 5 => 6
, 3 => 7
, 'a' => 4
, 11 // clé = 6 (index maximum : 5)
, '8' => 2 // clé = 8 (entier!)
, '02' => 77 // clé = '02'
, 0 => 12 // la valeur de la clé 10 sera remplacée par 12
);
// empty array
$empty = array();
?>`

Exemple 6-33. Collection

`<?php $couleurs = array('rouge','bleu','vert','jaune'); foreach ( $couleurs as $couleur ){ echo "Aimez-vous la couleur $couleur?\n"; } ?>`

L'exemple ci-dessus va afficher :

    Aimez-vous la couleur rouge?
    Aimez-vous la couleur bleu?
    Aimez-vous la couleur vert?
    Aimez-vous la couleur jaune?

Notez qu'il n'est pas possible actuellement de modifier les valeurs d'un tableau avec une telle boucle. Une solution pour cela est :

Exemple 6-34. Collection

`<?php foreach( $couleurs as $cle => $couleur ){ // ne marche pas //$couleur = strtoupper($couleur); //marche : $couleurs[$cle] = strtoupper($couleur); } print_r($couleurs);`

L'exemple ci-dessus va afficher :

    Array
    (
        [0] => ROUGE
        [1] => BLEU
        [2] => VERT
        [3] => JAUNE
    )

Cet exemple crée un tableau d'index minimal 1.

Exemple 6-35. Tableau en 1

`<?php $firstquarter = array(1 => 'Janvier', 'Février', 'Mars'); print_r($firstquarter);`

L'exemple ci-dessus va afficher :

    Array
    (
        [1] => 'Janvier'
        [2] => 'Février'
        [3] => 'Mars'
    )

Exemple 6-36. Remplissage d'un tableau

`<?php // remplit un tableau avec les noms de fichiers d'un dossier $handle = opendir('.'); while ( $file = readdir($handle) ){ $files[] = $file; } closedir($handle); ?>`

Les tableaux sont ordonnés. Vous pouvez modifier l'ordre des valeurs avec de nombreuses fonctions de classement. Voyez les fonctions de tableaux.

Exemple 6-37. Tri de tableaux

`<?php sort($files); print_r($files); ?>`

Comme une valeur de tableau peut être n'importe quoi, elle peut aussi être un autre tableau. Comme cela, vous pouvez avoir des tableaux multi-dimensionnels, ou récursifs.

Exemple 6-38. Tableaux multi-dimensionnels, et récursifs

`<?php
$fruits = array ( "fruits" => array ( "a" => "orange",
"b" => "banane",
"c" => "pomme"
),
"nombre" => array ( 1,
2,
3,
4,
5,
6,
),
"trou" => array ( "premier",
5 => "second",
"troisième"
)
);
// Exemples d'utilisations des tableaux ci-dessus
echo $fruits["trou"][5]; // affiche "second"
echo $fruits["fruits"]["a"]; // affiche "orange"
unset($fruits["trou"][0]); // supprime "premier"
// Créer un tableau multidimensionnel
$juices["pomme"]["vert"] = "bon";
?>`

Soyez conscients que l'assignation de valeur dans un tableau entraine automatiquement la copie de valeurs. Vous devez utiliser l'opérateur de référence pour copier un tableau par référence.

Exemple 6-39. Copie dans un tableau par référence

`<?php $arr1 = array(2, 3); $arr2 = $arr1; $arr2[] = 4; // $arr2 est modifié changed, // $arr1 vaut toujours array(2, 3) $arr3 = &$arr1; $arr3[] = 4; // maintenant $arr1 et $arr3 sont identiques ?>`

Précédent | Sommaire | Suivant
Les chaînes de caractères | Niveau supérieur | Les objets