(PHP 4, PHP 5, PHP 7, PHP 8)
array — Crée un tableau
Crée un tableau. Lisez la section sur les types tableaux pour plus d'informations sur ce qu'est un tableau.
valuesLa syntaxe "index => valeur", séparée par des virgules, définit les index et leur valeur. Un index peut être une chaîne ou un nombre. Si l'index est omis, un index numérique sera automatiquement généré (commençant à 0). Si l'index est un entier, le prochain index généré prendra la valeur d'index la plus grande + 1. Notez que si deux index identiques sont définis, le dernier remplacera le premier.
Avoir une virgule après avoir défini la dernière entrée, bien qu'inutile, est une syntaxe valide.
Retourne un tableau des paramètres. Les paramètres peuvent fournir
un index en utilisant l'opérateur =>.
Lisez la section sur les types-tableaux
pour plus d'informations sur ce qu'est un tableau.
L'exemple suivant montre comment créer un tableau à deux dimensions, comment spécifier les index d'un tableau associatif, et comment générer automatiquement des index numériques.
Exemple #1 Exemple avec array()
<?php
$fruits = array (
"fruits" => array("a" => "orange", "b" => "banana", "c" => "apple"),
"numbers" => array(1, 2, 3, 4, 5, 6),
"holes" => array("first", 5 => "second", "third")
);
?>
Exemple #2 Index automatique avec array()
<?php
$array = array(1, 1, 1, 1, 1, 8 => 1, 4 => 1, 19, 3 => 13);
print_r($array);
?>
L'exemple ci-dessus va afficher :
Array
(
[0] => 1
[1] => 1
[2] => 1
[3] => 13
[4] => 1
[8] => 1
[9] => 19
)
Notez bien que l'index '3' est défini deux fois, et conserve finalement sa dernière valeur de 13. L'index '4' est défini après l'index '8', et l'index généré suivant (valeur 19) est 9, puisque le plus grand index est alors 8.
Cet exemple crée un tableau dont les index commencent à 1.
Exemple #3 Index commençant à 1 avec array()
<?php
$firstquarter = array(1 => 'January', 'February', 'March');
print_r($firstquarter);
?>
L'exemple ci-dessus va afficher :
Array
(
[1] => January
[2] => February
[3] => March
)
Tout comme en Perl, vous pouvez accéder à une valeur d'un tableau dans des doubles guillemets. Cependant, avec PHP, vous devez entourer votre tableau avec des accolades.
Exemple #4 Accéder à un tableau dans des doubles guillemets
<?php
$foo = array('bar' => 'baz');
echo "Hello {$foo['bar']}!"; // Hello baz!
?>
Note:
array() est un constructeur de langage utilisé pour représenter littéralement les tableaux, mais ce n'est en aucun cas une fonction régulière.