A linguagem PHP fornece as funções nativas abaixo para manipulação do tipo de dado Array. Clique sobre o nome da função desejada para ser direcionado.

A função var_dump utilizada para a saída de dados nos exemplos abaixo pode ser vista em PHP Básico: Manipulando Variáveis em caso de dúvida.

1. array_change_key_case
2. array_chunk — Divide um array em partes
3. array_column — Retorna os valores de uma coluna
4. array_combine — Cria um array usando array de chaves e outro de valores
5. array_count_values
6. array_diff_assoc - Retorna a diferença(Conjunto) de elementos entre arrays
7. array_diff_key
8. array_diff_uassoc — Retorna a diferença(Conjunto) de elementos entre arrays baseado em função
9. array_diff_ukey
10. array_diff
11. array_fill_keys
12. array_fill — Preenche array com valores definidos
13. array_filter — Filtra elementos de um array baseado em função
14. array_flip
15. array_intersect_assoc
16. array_intersect_key
17. array_intersect_uassoc
18. array_intersect_ukey
19. array_intersect
20. array_is_list
21. array_key_exists — Verificar se uma chave existe em um array
22. array_key_first
23. array_key_last
24. array_keys — Retorna um array contendo todos as chaves de um array
25. array_map
26. array_merge_recursive
27. array_merge — Concatena um ou mais arrays
28. array_multisort
29. array_pad
30. array_pop — Remove um elemento do fim do array
31. array_product
32. array_push — Adiciona um ou mais valores no fim do array
33. array_rand
34. array_reduce
35. array_replace_recursive
36. array_replace
37. array_reverse — Retorna um array com elementos em ordem reversa
38. array_search — Busca de um valor e retorna a sua chave
39. array_shift — Remove um elemento do início
40. array_slice — Extrai elementos de um array
41. array_splice
42. array_sum — Retorna a somo dos elementos do array
43. array_udiff_assoc
44. array_udiff_uassoc
45. array_udiff
46. array_uintersect_assoc
47. array_uintersect_uassoc
48. array_uintersect
49. array_unique — Remove elementos repetidos
50. array_unshift — Adiciona um ou mais elementos do início de um array
51. array_values
52. array_walk_recursive
53. array_walk — Executa uma função para todos os elementos do array
54. array — Cria um array
55. arsort
56. asort
57. compact
58. count — Retorna número de elementos do array
59. current — Retorna elementos na posição atual do array
60. each — Depreciado
61. end — Avança o ponteiro interno para último elemento
62. extract
63. in_array
64. key_exists
65. key
66. krsort — Ordena de forma descendente
67. ksort — Ordena de forma ascendente
68. list — Atribui elementos de um array à variáveis. unpacking
69. natcasesort
70. natsort
71. next — Avança o ponteiro interno do array
72. pos — O mesmo que current
73. prev — Retrocede o ponteiro interno para o primeiro elemento
74. range
75. reset — Posiciona o ponteiro interno no primeiro elemento do array
76. rsort — Ordena um array de forma descendente
77. shuffle — Embaralha elementos do array
78. sizeof — o mesmo que count
79. sort — Ordena os elementos do array em ordem ascendente
80. uasort
81. uksort
82. usort

A função array_chunk divide um array em um número de partes que é passado como argumento para o método.

Sintaxe

array_chunk(array $array, int $length, bool $preserve_keys = false): array

Onde

$array: Array que será manipulado
$length: Número  de partes para dividir $array

$preserve_keys: Booleano para preservar chaves existentes 
true: manter
false: reindexar chaves

Retorno

Um novo array contendo $length elementos contendo as partes de $array

Exemplo

<?php
   $array = array (    'ch1' => 1,    'ch2' => 2    'ch3' => 3,    'ch4' => 4, );
   $partes = (array_chunk($array,2));
   var_export($partes[0]);
   var_export($partes[1]);
?>

Saída

array (  0 => 1,  1 => 2,)
array (  0 => 3,  1 => 4,)

A função combine combina 2 arrays, contendo chaves e valores respectivamente, em um array associativo.

Sintaxe

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

Onde

$keys: array contendo as lista de chaves
$values: array contendo as lista de valores.

Retorno

Um novo array contendo $length elementos contendo as partes de $array

Exemplo

<?php
   $chaves = array("ch1","ch2","ch3");
   $valores = array(1,2,3);
    
   $array = array_combine($chaves,$valores);
   var_export($array);

?>

Saída

array (  'ch1' => 1,  'ch2' => 2,  'ch3' => 3,)

Com a função column podemos recuperar o valor contido em uma coluna de um array que passada com argumento.

Sintaxe

array_column(array $array, int|string|null $column_key, int|string|null $index_key = null): array

Onde

$array: array que desejamos buscar um valor
$index_key: Coluna usada como índice de $array. Opcional
$column: nome da coluna que desejamos buscar o valor

Retorno

Um novo array contendo os valores da coluna

Exemplo

<?php
$array = array (
      array(          "ch1" => 1,          "ch2" => "string1"      ),
      array(          "ch1" => 2,          "ch2" => 'string2'      ),
    );
    //todos os valores da coluna ch2
    $array_ret = array_column($array,"ch2");
    var_dump($array_ret);
?>

Saída

array(2) {  [0]=>  string(7) "string1"  [1]=>  string(7) "string2"}

A função array_diff_assoc retorna a diferença de elementos contidos em 2 ou mais arrays. A diferença diz respeito a operação aplicada a conjuntos de valores.

Sintaxe

array_diff_assoc(array $array, array ...$arrays): array

Onde

$array: arrays contendo os elementos para comparação

Retorno

Um novo array contendo os valores da coluna

Exemplo

<?php
    $array1 = array( "ch1" => 1, "ch2" => "string1"    );
    $array2 = array( "ch1" => 1, "ch3" => "string3"    );
    
    $array_ret = array_diff_assoc($array1,$array2);
    
    var_dump($array_ret);
?>

Saída

array(1) {  ["ch2"]=>  string(7) "string1"}

A função array_diff_assoc retorna a diferença de elementos contidos em 2 ou mais arrays utilizando um função do usuário. A diferença diz respeito a operação aplicada a conjuntos de valores.

Sintaxe

array_diff_uassoc(array $array, array ...$arrays, callable $key_compare_func): array

Onde

...$arrays: arrays utilizados para comparação
$array: arrays contendo os elementos para retornar a diferença.
$key_compare_func: função do usuário passada como parâmetro

Retorno

Um novo array contendo a diferença.

Exemplo

<?php
    $array1 = array( "ch1" => 1, "ch2" => "string1" );
    $array2 = array( "ch1" => 1, "ch3" => "string3" );
    
    function funcao($valor1, $valor2){
      
      if ($valor1 === $valor2){
        return 0;
      }
      else{
        if($valor1 > $valor2){
          return 1;
        }
        else{
          return -1;
        }
      }
    }
    
    $array_ret = array_diff_uassoc($array1,$array2,"funcao");
    var_dump($array_ret);
?>

Saída

array(1) {  ["ch2"]=>  string(7) "string1"}

Com a função array_fill é possível preencher todo um array com valores, passados como argumento, definidos pelo usuário.

Sintaxe

array_fill(int $start_index, int $count, mixed $value): array

Onde

$start_index: índice inicial para preenchimento
$count: quantidade de elementos preenchidos
$value: valor utilizado para preenchimento

Retorno

Um novo array contendo a diferença.

Exemplo

<?php
    $array1 = array(1,2,3);
    $novo_array = array_fill(0,3,777);
    var_dump($novo_array);
?>

Saída

array(3) {  [5]=>  int(777)  [6]=>  int(777)  [7]=>  int(777)}

Com a função array_filter podemos filtrar elementos de um array baseado em uma função customizada que é passsada como argumento.

Sintaxe

array_filter(array $array, ?callable $callback = null, int  $mode = 0): array

Onde

$array: array para filtrar
$callback: Função do usuário para filtro

$mode: Modo de filtro:
ARRAY_FILTER_USE_KEY - Passar como argumento apenas chave para $callback. Padrão
ARRAY_FILTER_USE_BOTH - Passar como argumento chave e valor para $callback

Retorno

Um novo array contendo a elementos filtrados por $callback

Exemplo

<?php
    $array1 = array(0,1,2,3,4,5,6,7,8,9,10);
        
    function funcao($valor){
      if ($valor %2 == 0)
        return $valor;
    }
    $array_ret = array_filter($array1,"funcao");
    print_r($array_ret);
?>

Saída

Array
(
    [2] => 2
    [4] => 4
    [6] => 6
    [8] => 8
    [10] => 10
)

Utilizando a função array_key_exists, podemos verificar se uma chave existe em um array associativo.

Sintaxe

array_key_exists(string|int $key, array $array): bool

Onde

$array: array que desejamos consultar $key
$key: chave que desejamos buscar

Retorno

true se $key existe, false caso contrário

Exemplo

<?php
  $array = array(    "ch1" => 100,    "ch2" => 200,    "ch3" => 400  );
  
  $chave = "ch3";
  $exist = array_key_exists($chave,$array);
  var_dump($exist);
?>

Saída

bool(true)

Usando a função array_keys, podemos recuperar um array contendo todas as chaves de um array associativo que é passado como argumento para a função.

Sintaxe

array_keys(array $array): array
array_keys(array $array, mixed $filter_value, bool $strict = false): array

Onde

$array: array que contém as chaves que desejamos obter

Retorno

Um novo array com chaves de $array

Exemplo

<?php
  $array = array( "ch1" => 100, "ch2" => 200, "ch3" => 400  );
  
  $chaves = array_keys($array);
  var_dump($chaves);
?>

Saída

array(3) {  [0]=>  string(3) "ch1"  [1]=>  string(3) "ch2"  [2]=>  string(3) "ch3"}

A função array_merge faz a união ou concatenação de um ou mais arrays passados como argumentos.

Sintaxe

array_merge(array ...$arrays): array

Onde

$array: array que contém as chaves que desejamos unir

Retorno

Novo array contendo os elementos $arrays unidos ou concatenados

Exemplo

<?php
  $array1 = array(    "ch1" => 100,  );
  
  $array2 = array(    "ch2" => 200,  );
  
  $retorno = array_merge($array1,$array2);
  var_dump($retorno);

?>

Saída

array(2) {  ["ch1"]=>  int(100)  ["ch2"]=>  int(200)}

A função array_pop remove um elemento do fim de um array retornando esse elemento removido.

Sintaxe

array_pop(array &$array): mixed

Onde

$array: array que será manipulado

Retorno

Elemento removido

Exemplo

<?php
    $array1 = array(1,2);
    var_dump($array1);
    $elem = array_pop($array1);
    var_dump($array1);
    var_dump($elem);  
?>

Saída

array(2) {  [0]=>  int(1)  [1]=>  int(2)}
array(1) {  [0]=>  int(1)}
int(2)

A função array_push adiciona um ou mais valores no fim de um array retornando o número de elementos total contidos no array.

Sintaxe

array_push(array &$array, mixed ...$values): int

Onde

$array: array que será manipulado
$values: um ou mais valores para inserção.

Retorno

Elemento adicionado

Exemplo

<?php
    $array1 = array(1);
    var_dump($array1);
    array_push($array1,2);
    var_dump($array1);
?>

Saída

array(1) {  [0]=>  int(1)}
array(2) {  [0]=>  int(1)  [1]=>  int(2)}

A função array_reverse retorna um novo array, que é passado como argumento, em ordem reversa.

Sintaxe

array_reverse(array $array, bool $preserve_keys = false): array

Onde

$array: array que desejamos manipular.
$preserve_keys: booleano que indica se as chaves numéricas devem ser mantidas.

Retorno

Novo array contendo elementos em ordem reversa

Exemplo

<?php
  $array1 = array(1,2,3);
  $retorno = array_reverse($array1);  
  var_dump($retorno);
?>

Saída

array(3) {  [0]=>  int(3)  [1]=>  int(2)  [2]=>  int(1)}

A função array_serach permite a busca de um valor e retorna a chave associada a esse valor se existir.

Sintaxe

array_search(mixed $needle, array $haystack, bool $strict = false): int|string|false

Onde

$haystack: array que contém o valor a ser buscado
$needle: valor que será buscado
$strict: booleano que indica se a busca será feita usando strict. O valor buscado será feito usando (===).

Retorno

Inteiro ou string contendo a chave associada a $needdle ou false caso contrário.

Exemplo

<?php
  $array = array(    "ch1" => 100,    "ch2" => 200,    "ch3" => 400  );
  $retorno = array_search(200,$array);
  var_dump($retorno);
?>

Saída

string(3) "ch2"

A função array_shift remove um elemento do início do array retornando esse elemento removido.

Sintaxe

array_shift(array &$array): mixed

Onde

$array: array para remoção do primeiro elemento

Retorno

Primeiro elemento de $array

Exemplo

<?php
    $array1 = array(1,2);
    var_dump($array1);
    $elem = array_shift($array1);
    var_dump($array1);
    var_dump($elem);
?>

Saída

array(2) {  [0]=>  int(1)  [1]=>  int(2)}
array(1) {  [0]=>  int(2)}
int(1)

Com a função array_slice podemos fazer uma cópia dos elementos de um array baseado em um intervalo passado como argumento.

Sintaxe

array_slice( array $array, int $offset, ?int $length = null, bool $preserve_keys = false): array

Onde

$array: array que de onde os elementos serão copiados
$offset: índice do primeiro elemento pertencente ao intervalo
$length: quantidade de elementos para copiar
$preserve_keys: booleano que indica se as chaves numéricas devem ser mantidas.

Retorno

Novo array contendo os elementos copiados de $offset a $length.

Exemplo

<?php
  $array = array(
    "ch1" => 100,
    "ch2" => 200,
    "ch3" => 400,//elemento copiado
    "ch4" => 600,//elemento copiado
    "ch5" => 800,//elemento copiado
    "ch2" => 900,
    "ch3" => 950
  );
  //slice de ch3 até ch5
  $retorno = array_slice($array,2,3);
  var_dump($retorno);
?>

Saída

array(3) {  ["ch3"]=>  int(950)  ["ch4"]=>  int(600)  ["ch5"]=>  int(800)}

Com a função array_sum podemos recuperar a soma de todos os valores de um array.

Sintaxe

array_sum(array $array): int|float

Onde

$array: array contendo os valores que serão somados

Retorno

Integer ou float contendo o somatório dos elementos de $array

Exemplo

<?php
  $array = array(    "ch1" => 1,    "ch2" => 2,    "ch3" => 4, );
  $retorno = array_sum($array);
  var_dump($retorno);
?>

Saída

int(7)

A função array_unique é utilizada para remover todos os elementos repetidos contidos em um array.

Sintaxe

array_unique(array $array, int $flags = SORT_STRING): array

Onde

$array: array que será manipulado
$flags: Tipo de ordenação. A flag padrão é SORT_REGULAR.
SORT_NUMERIC: Comparação como número
SORT_STRING: Comparação como string
SORT_LOCALE_STRING: Comparação como string baseado em configuração de setlocale().
SORT_NATURAL: Comparação como string baseado em ordem natural

Retorno

Novo array contendo elementos únicos contidos em $array.

Exemplo

<?php
 $array = array(1,1,2,3,4,4);

  var_dump($array);  
  $retorno = array_unique($array);
  var_dump($retorno);
?>

Saída

array(6) {  [0]=>  int(1)  [1]=>  int(1)  [2]=>  int(2)  [3]=>  int(3)  [4]=>  int(4)  [5]=>  int(4)}
array(4) {  [0]=>  int(1)  [2]=>  int(2)  [3]=>  int(3)  [4]=>  int(4)}

A função array_unshift adiciona um elemento do início de um array retornando esse elemento.

Sintaxe

array_unshift(array &$array, mixed ...$values): int

Onde

$array: array manipulado
$values: um ou mais valores para remover

Retorno

Número de elementos de $array

Exemplo

<?php
    $array1 = array(2);
    var_dump($array1);
    array_unshift($array1,1);
    var_dump($array1);
?>

Saída

array(1) {  [0]=>  int(2)}
array(2) {  [0]=>  int(1)  [1]=>  int(2)}

A função array_walk permite que uma função definida pelo usuário, passada como argumento, seja executada para cada elementos do array.

Sintaxe

array_walk(array|object &$array, callable $callback, mixed $arg = null): bool

callback($value);
callback($value,$key);

Onde

$callback:  função passada como argumento
$array: array que será manipulado
$arg: argumentos de callback

$value: valor do elemento
$key: chave do elemento

Retorno

true

Exemplo

<?php
  $array = array(1,2,3);

  function funcao(&$elemento){
    echo $elemento;
  }
  array_walk($array,funcao);
?>

Saída

123

A função count retorna a quantidade de elementos contidos em um array que é passado como argumento.

Sintaxe

count(Countable|array $value, int $mode = COUNT_NORMAL): int

Onde

$value: array que será contado seus elementos
$mode: Inteiro que informa o modo que a contagem é feita. Padrão COUNT_NORMAL

Retorno

Inteiro contendo o número de elementos contido em $value

Exemplo

<?php
  $array = array("ch1" =>1,"ch2" =>2, "ch3" =>3);
  $tamanho = count($array);
  echo $tamanho
?>

Saída

3

A função current retorna o elemento na posição atual do array e avança o ponteiro do iterador do array em uma posição.

Sintaxe

current(array|object $array): mixed

Onde

$array: array para retornar posição

Retorno

Elemento na posição atual

Exemplo

<?php
    $array1 = array( "chave1" => 1, "chave2" => 2, "chave3" => 3   );
    var_dump(current($array1));
?>

Saída

int(1)

Com a função end podemos avançar o ponteiro interno do iterador do array para o último elemento retornando seu valor.

Sintaxe

end(array|object &$array): mixed

Onde

$array: array manipulado

Retorno

Valor do elemento na posição final do array ou false caso array seja vazio

Exemplo

<?php
    $array1 = array( "chave1" => 1, "chave2" => 2, "chave3" => 3   );
    var_dump(end($array1));
?>

Saída

int(3)

A função key retorna o valor de uma chave na posição atual do ponteiro interno do iterador de um array.

Sintaxe

key(array|object $array): int|string|null

Onde

$array: array que de onde a chave será recuperada

Retorno

Inteiro ou string contendo a chave recuperada de $array. null se chave não existir

Exemplo

<?php
  $array = array( "ch1" => 1, "ch2" => 2, "ch3" => 4,  );
  next($array);
  $retorno = key($array);
  var_dump($retorno);
?>

Saída

string(3) "ch2"

Com a função krsort, podemos ordenar as chaves de um array associativo de forma descendente.

Sintaxe

krsort(array &$array, int $flags = SORT_REGULAR): bool

Onde

$array: array que será ordenado
$flags: Tipo de ordenação. A flag padrão é SORT_REGULAR
SORT_NUMERIC: Comparação como número
SORT_STRING: Comparação como string
SORT_LOCALE_STRING: Comparação como string baseado em configuração de setlocale().
SORT_NATURAL: Comparação como string baseado em ordem natural

Retorno

true

Exemplo

<?php
  $array = array( "ch1" => 1, "ch2" => 2, "ch3" => 4,  );
  $retorno = krsort($array);
  var_dump($array);
  var_dump($retorno);
?>

Saída

array(3) {  ["ch3"]=>  int(4)  ["ch2"]=>  int(2)  ["ch1"]=>  int(1)}
bool(true)

Utilizando a função ksort, podemos ordenar as chaves de um array associativo de forma ascendente.

Sintaxe

ksort(array &$array, int $flags = SORT_REGULAR): true

Onde

$array: array que será ordenado
$flags: Tipo de ordenação. A flag padrão é SORT_REGULAR
SORT_NUMERIC: Comparação como número
SORT_STRING: Comparação como string
SORT_LOCALE_STRING: Comparação como string baseado em configuração de setlocale().
SORT_NATURAL: Comparação como string baseado em ordem natural

Retorno

true

Exemplo

<?php
  $array = array( "ch3" => 1, "ch2" => 2, "ch1" => 4  );
  $retorno = ksort($array);
  var_dump($array);
  var_dump($retorno);
?>

Saída

array(3) {  ["ch1"]=>  int(4)  ["ch2"]=>  int(2)  ["ch3"]=>  int(1)}
bool(true)

Usando a função list, podemos atribuir valores de elementos contidos em um array à várias variáveis.

Sintaxe

list(mixed $var, mixed ...$vars = ?): array

Onde

$var: lista de variáveis separadas por (,)

Retorno

Valores de um array que serão associadas as variáveis $vars.

Exemplo

<?php
$array = array(1,2,3);
  
  $vl1;
  $vl2;
  $vl3;
  
  //todos os valores
  list($vl1,$vl2,$vl3) = $array;
  //apenas segundo valor
  list(,$vl2,) = $array;
  //apenas 1o e 3o elementos
  list($vl1, ,$vl3) = $array;  
  
  echo $vl1,$vl2,$vl3
?>

Saída

123

Com a função next, podemos avançar o ponteiro interno de um array e retornar o elemento na posição atual.

Sintaxe

next(array|object &$array): mixed

Onde

$array: array manipulado

Retorno

Elemento na próxima posição do array

Exemplo

<?php
    $array1 = array( "chave1" => 1, "chave2" => 2, "chave3" => 3 );
    var_dump(current($array1));
    var_dump(next($array1));
?>

Saída

int(1)
int(2)

A função prev retrocede o ponteiro interno do iterador de um array e retorna o elemento na posição atual.

Sintaxe

prev(array|object &$array): mixed

Onde

$array: array manipulado

Retorno

Elemento na posição anterior à atual do array

Exemplo

<?php
    $array1 = array(
      "chave1" => 1,
      "chave2" => 2,
      "chave3" => 3
    );
    
    var_dump(next($array1));
    var_dump(prev($array1));
?>

Saída

int(2)
int(1)

Utilizando a função reset posicionamos o ponteiro interno do iterador de um array para o primeiro elemento e retornar seu valor.

Sintaxe

reset(array|object &$array): mixed

Onde

$array: array manipulado

Retorno

Elemento da posição posição inicial do array

Exemplo

<?php
    $array = array( "chave1" => 1, "chave2" => 2, "chave3" => 3 );
    
    var_dump(next($array));
    var_dump(next($array));
    var_dump(reset($array));
?>

Saída

int(1)

Usando a função rsort os elementos contidos em um array são ordenados em ordem descendente.

Sintaxe

rsort(array &$array, int $flags): bool

Onde

$array: array para ordenar
$flags: Tipo de ordenação. A flag padrão é SORT_REGULAR.
SORT_NUMERIC: Comparação como número
SORT_STRING: Comparação como string
SORT_LOCALE_STRING: Comparação como string baseado em configuração de setlocale().
SORT_NATURAL: Comparação como string baseado em ordem natural

Retorno

true

Exemplo

<?php
    $array = array( "chave1" => 1, "chave2" => 2, "chave3" => 3 );
    
    var_dump(next($array));
    var_dump(next($array));
    var_dump(reset($array));
?>

Saída

int(1)

A função shuffle nos permite embaralhar os elementos contidos em um array.

Sintaxe

shuffle(array &$array): bool

Onde

$array: array que será embaralhado

Retorno

true

Exemplo

<?php
    $array1 = array(1,2,3,4,5,6);
    var_dump($array1);
    shuffle($array1);
    var_dump($array1);
?>

Saída

array(6) {  [0]=>  int(1)  [1]=>  int(2)  [2]=>  int(3)  [3]=>  int(4)  [4]=>  int(5)  [5]=>  int(6)}
array(6) {  [0]=>  int(5)  [1]=>  int(2)  [2]=>  int(3)  [3]=>  int(1)  [4]=>  int(6)  [5]=>  int(4)}

Usando a função sort, os elementos contidos em um array são ordenados em ordem ascendente.

Sintaxe

sort(array &$array, int $flags): bool

Onde

$array: array para ordenar
$flags: Tipo de ordenação. A flag padrão é SORT_REGULAR
SORT_NUMERIC: Comparação como número
SORT_STRING: Comparação como string
SORT_LOCALE_STRING: Comparação como string baseado em configuração de setlocale().
SORT_NATURAL: Comparação como string baseado em ordem natural

Retorno

true

Exemplo

<?php
    $array1 = array("banana","amora","carambola");
    var_dump($array1);
    sort($array1);
    var_dump($array1);
?>

Saída

array(3) {  [0]=>  string(6) "banana"  [1]=>  string(5) "amora"  [2]=>  string(9) "carambola"}
array(3) {  [0]=>  string(5) "amora"  [1]=>  string(6) "banana"  [2]=>  string(9) "carambola"}

1. 25/08/2025 - revisão 3 - Ajustes: pontuais, sintaxes e targets
2. 03/09/2024 - revisão 2 - Correção em links combine e column
4. 06/02/2024 - revisão 1 - correção em navegação e erros gramaticais
5. 20/09/2023 - versão inicial