(PHP 5 >= 5.5.0, PHP 7)
array_column — Retourne les valeurs d'une colonne d'un tableau d'entrée
array_column() retourne les valeurs d'une colonne du
tableau d'entrée array
, identifiée par la clé
column_key
. Optionnellement, vous pouvez fournir
un paramètre index_key
pour indexer les valeurs dans le
tableau retourné par les valeurs de la colonne index_key
du tableau d'entrée.
array
Un tableau multi-dimensionnel depuis lequel la colonne de valeurs sera prélevée.
column_key
La colonne de valeurs à retourner. Cette valeur peut être la clé
entière de la colonne que vous souhaitez récupérer, ou bien le nom
de la clé pour un tableau associatif. Il peut aussi valoir NULL
pour retourner le tableau complet (utile en conjonction du paramètre
index_key
pour ré-indexer le tableau).
index_key
La colonne à utiliser comme index/clé pour le tableau retourné. Cette valeur peut être la clé entière de la colonne, ou le nom de la clé.
Retourne un tableau de valeurs représentant une seule colonne depuis le tableau d'entrée.
Exemple #1 Récupère la colonne des prénoms
<?php
// Tableau représentant un jeu d'enregistrements issu d'une base de données
$records = array(
array(
'id' => 2135,
'first_name' => 'John',
'last_name' => 'Doe',
),
array(
'id' => 3245,
'first_name' => 'Sally',
'last_name' => 'Smith',
),
array(
'id' => 5342,
'first_name' => 'Jane',
'last_name' => 'Jones',
),
array(
'id' => 5623,
'first_name' => 'Peter',
'last_name' => 'Doe',
)
);
$first_names = array_column($records, 'first_name');
print_r($first_names);
?>
L'exemple ci-dessus va afficher :
Array ( [0] => John [1] => Sally [2] => Jane [3] => Peter )
Exemple #2 Récupère la colonne des noms, indexé par la colonne "id"
<?php
// En utilisant le tableau de l'exemple #1
$last_names = array_column($records, 'last_name', 'id');
print_r($last_names);
?>
L'exemple ci-dessus va afficher :
Array ( [2135] => Doe [3245] => Smith [5342] => Jones [5623] => Doe )