array_columnRetourne les valeurs d'une colonne d'un tableau d'entrée
&reftitle.description;
arrayarray_columnarrayarrayintstringnullcolumn_keyintstringnullindex_key&null;array_column retourne les valeurs d'une colonne de array, identifiée par la clé
column_key. Optionnellement, il est possible de 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.
&reftitle.parameters;
array
Un tableau multidimensionnel ou un tableau d'objets à partir duquel
on extrait une colonne de valeur. Si un tableau d'objets est fourni,
alors les propriétés publiques peuvent être directement extraites.
Pour que les propriétés protected ou private soient extraites,
la classe doit implémenter les deux méthodes magiques
__get et __isset.
column_key
La colonne de valeurs à retourner. Cette valeur peut être la clé
entière de la colonne que l'on souhaite récupérer, ou bien le
nom de la clé pour un tableau associatif ou le nom de la propriété.
Il peut aussi valoir &null; pour retourner le tableau complet ou
des objets (ceci peut être 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é.
La valeur est cast
comme d'habitude pour les clés du tableau (cependant, antérieur à PHP 8.0.0,
les objets qui supportent une conversion en chaîne de caractères étaient aussi autorisés).
&reftitle.returnvalues;
Retourne un tableau de valeurs représentant une seule colonne depuis le
tableau d'entrée.
&reftitle.changelog;
&Version;&Description;8.0.0
Les objets dans les colonnes indiquées par le paramètre index_key
ne seront plus convertis en chaîne de caractères et lanceront désormais
une TypeError à la place.
&reftitle.examples;
Récupère la colonne des prénoms
2135,
'first_name' => 'John',
'last_name' => 'Doe',
],
[
'id' => 3245,
'first_name' => 'Sally',
'last_name' => 'Smith',
],
[
'id' => 5342,
'first_name' => 'Jane',
'last_name' => 'Jones',
],
[
'id' => 5623,
'first_name' => 'Peter',
'last_name' => 'Doe',
]
];
$first_names = array_column($records, 'first_name');
print_r($first_names);
?>
]]>
&example.outputs;
John
[1] => Sally
[2] => Jane
[3] => Peter
)
]]>
Récupère la colonne des noms, indexé par la colonne "id"
2135,
'first_name' => 'John',
'last_name' => 'Doe',
],
[
'id' => 3245,
'first_name' => 'Sally',
'last_name' => 'Smith',
],
[
'id' => 5342,
'first_name' => 'Jane',
'last_name' => 'Jones',
],
[
'id' => 5623,
'first_name' => 'Peter',
'last_name' => 'Doe',
]
];
$last_names = array_column($records, 'last_name', 'id');
print_r($last_names);
?>
]]>
&example.outputs;
Doe
[3245] => Smith
[5342] => Jones
[5623] => Doe
)
]]>
Récupère la colonne des username depuis la propriété publique
"username" d'un objet
username = $username;
}
}
$users = [
new User('user 1'),
new User('user 2'),
new User('user 3'),
];
print_r(array_column($users, 'username'));
?>
]]>
&example.outputs;
user 1
[1] => user 2
[2] => user 3
)
]]>
Récupère la colonne nom depuis la propriété privée "name" d'un
objet en utilisant les méthodes magiques <function>__isset</function> et
<function>__get</function>
name = $name;
}
public function __get($prop)
{
return $this->$prop;
}
public function __isset($prop) : bool
{
return isset($this->$prop);
}
}
$people = [
new Person('Fred'),
new Person('Jane'),
new Person('John'),
];
print_r(array_column($people, 'name'));
?>
]]>
&example.outputs;
Fred
[1] => Jane
[2] => John
)
]]>
Si __isset est non défini, alors un tableau
vide sera retourné.