Funkcja PHP array_column() zwraca wartości z określonej kolumny tablicy. Funkcja ta działa na tablicach wielowymiarowych i na tablicach obiektów.
Składnia funkcji PHP array_column()
Funkcja PHP array_column() ma następującą składnię:
array_column(array $array, int|string|null $column_key, int|string|null $index_key = null): array
Parametry
| Parametr | Opis |
|---|---|
| array | Parametr obowiązkowy. Tablica wielowymiarowa lub tablica obiektów, z których można pobrać wartości kolumn. |
| column_key | Parametr obowiązkowy. Nazwa kolumny, z której wartości mają zostać zwrócone. W przypadku tablicy może to być indeks całkowitoliczbowy albo klucz w postaci łańcucha, a w przypadku obiektu może to być nazwa własności. Ewentualnie można przekazać wartość null, aby zwrócić całą tablicę lub cały obiekt (aby np. reindeksować tablicę przez dodanie parametru index_key). |
| index_key | Kolumna, której wartości mają zostać użyte jako indeksy w zwróconej tablicy. Wartością tego parametru może być liczba całkowita PHP lub klucz łańcuchowy. |
Wartość zwrotna
Funkcja PHP array_column() zwraca tablicę PHP reprezentującą jedną kolumnę z tablicy wejściowej.
Typ zwrotny: array.
Dodatkowy przykład
Poniżej znajduje się przykład użycia funkcji array_column() z parametrem index_key:
$owoce = [
[
"owoc" => "pomarańcza",
"ilość" => 10,
"kaloryczność" => 47,
],
[
"owoc" => "banan",
"ilość" => 7,
"kaloryczność" => 88,
],
[
"owoc" => "jabłko",
"ilość" => 4,
"kaloryczność" => 52,
],
];
var_dump(array_column($owoce, "owoc", "kaloryczność"));
Wynik:
array(3) {
[47]=>
string(11) "pomarańcza"
[88]=>
string(5) "banan"
[52]=>
string(7) "jabłko"
}
