PHP 8 reference · Array Functions

PHP array_combine() Function

Create an array by using one array for keys and another for values. Both arrays must have the same number of elements.

Create a free account to save this page, take notes and track your progress. Sign in

Syntax

array_combine(array $keys, array $values): array

Parameter	Description
`keys`	The keys (strings or integers).
`values`	The values, matched by position.

The combined array.

Keys plus valuesTry it yourself

<?php
print_r(array_combine(["name", "age"], ["Ada", 36]));

Output

Array
(
    [name] => Ada
    [age] => 36
)

Turn a CSV row into a recordTry it yourself

<?php
$header = ["id", "title"];
$row = ["7", "Arrays in PHP"];
$record = array_combine($header, $row);
echo $record["title"], "\n";

Output

Arrays in PHP

Lengths must matchTry it yourself

<?php
try {
    array_combine(["a", "b"], [1]);
} catch (ValueError $e) {
    echo $e->getMessage(), "\n";
}

Output

array_combine(): Argument #1 ($keys) and argument #2 ($values) must have the same number of elements

Version	Change
PHP 5.0	Added
PHP 8.0	Throws a `ValueError` when the counts differ, instead of returning `false`.

array_fill_keys() · Create an array from a list of keys, giving every key the same value. Useful for defaults and counters.
array_flip() · Swap keys and values, so each value becomes a key. Values must be strings or integers; duplicates keep the last key.
array_keys() · Return all the keys of an array, or only the keys whose value matches a search value.
array_values() · Return all the values of an array as a list re-indexed from 0. Often used after array_filter() or unset().
PHP Arrays · tutorial
PHP Array Functions · tutorial