PHP 배열 추가 array_push(): 요소 넣는 방법

array_push($arr, $value)는 배열 끝에 값을 추가합니다. 값 하나라면 축약형 $arr[] = $value;가 함수 호출 없이 같은 일을 하며, 대부분의 PHP 코드가 이 방식을 씁니다. 둘 다 원래 배열을 바꿉니다.

<?php
$colors = ['red', 'green'];

$colors[] = 'blue';                    // shorthand, one value
array_push($colors, 'yellow', 'pink'); // several values at once

print_r($colors);

array_push()는 배열을 참조로 받으므로 전달한 변수를 수정합니다. 새 요소 개수를 반환하지만 무시해도 됩니다.

array_push와 $arr[] = 비교

값 하나에는 $arr[] = $value를 쓰세요. 더 짧고 함수 호출이 없어서 큰 반복문 안에서는 차이가 쌓입니다. 한 문장으로 여러 값을 추가하거나 값 목록을 펼쳐 넣을 때는 array_push()를 쓰세요.

<?php
$log = [];
for ($i = 1; $i <= 3; $i++) {
    $log[] = "step $i";
}

$more = ['step 4', 'step 5'];
$count = array_push($log, ...$more);   // spread a list in

print_r($log);
echo "Now $count entries\n";

$arr[] =는 아직 존재하지 않는 변수에도 동작하며, PHP가 배열을 만들어 줍니다. array_push()는 기존 배열이 필요합니다. 정의되지 않은 변수에 쓰면 TypeError: array_push(): Argument #1 ($array) must be of type array, null given을 던집니다.

키와 값 추가하기

array_push()는 다음 정수 키로 값을 덧붙이기만 합니다. 이름 있는 키를 추가하려면 그 키에 대입하세요. 여러 쌍을 한 번에 추가하려면 +=(기존 키 유지)나 array_merge()(새 값이 이김)를 쓰세요.

<?php
$user = ['name' => 'Ada'];

$user['email'] = 'ada@example.com';             // one key and value
$user += ['role' => 'admin', 'name' => 'X'];    // adds role; name already exists, kept

print_r($user);

array_push($user, 'oops');                      // gets key 0, not a name
print_r($user);

키가 겹칠 때 +와 array_merge()의 차이는 array_merge 페이지에서 다룹니다.

맨 앞에 추가하기: array_unshift

array_unshift($arr, $value)는 처음에 삽입합니다. 정수 키는 다시 매겨져 새 값이 인덱스 0을 가지며, 문자열 키는 그대로입니다. array_push()처럼 여러 값을 받고 새 개수를 반환합니다.

<?php
$queue = ['Linus', 'Grace'];
array_unshift($queue, 'Ada');
print_r($queue);

$menu = ['home' => '/', 'about' => '/about'];
array_unshift($menu, '/login');      // string keys are kept, the new value gets key 0
print_r($menu);

이름 있는 쌍을 맨 앞에 두려면 새 배열을 만드세요: $menu = ['login' => '/login'] + $menu;.

특정 위치에 삽입하기

array_splice($arr, $offset, 0, $values)는 아무것도 지우지 않고 삽입합니다. $offset에서 시작해 0개의 요소를 지우고 그 자리에 새 값을 넣습니다. 삽입 지점 이후의 정수 키는 다시 매겨집니다.

<?php
$letters = ['a', 'b', 'd', 'e'];

array_splice($letters, 2, 0, 'c');           // insert 'c' at index 2
print_r($letters);

array_splice($letters, 1, 0, ['x', 'y']);    // insert two values at index 1
echo implode(' ', $letters), "\n";

array_splice()는 요소를 지우고 바꾸는 일도 할 수 있습니다. 그 형태는 요소 제거 페이지에서 볼 수 있습니다.

다른 배열 덧붙이기

array_push($a, $b)는 $b를 중첩된 요소 하나로 추가하는데, 이는 원하는 결과가 아닌 경우가 대부분입니다. $b의 값을 하나씩 추가하려면 펼쳐 넣거나, 스프레드 문법이나 array_merge()로 새 배열을 만드세요.

<?php
$a = [1, 2];
$b = [3, 4];

$nested = $a;
array_push($nested, $b);       // [1, 2, [3, 4]]
echo json_encode($nested), "\n";

$flat = $a;
array_push($flat, ...$b);      // [1, 2, 3, 4]
echo json_encode($flat), "\n";

echo json_encode([...$a, ...$b]), "\n";

흔한 실수: 반환값 대입하기

array_push()는 새 요소 개수라는 숫자를 반환합니다. 이를 배열 변수에 다시 대입하면 배열이 정수로 바뀌고, 그 변수에 다음 array_push()를 하면 TypeError가 납니다.

<?php
$items = ['pen', 'book'];

$result = array_push($items, 'lamp');
var_dump($result);    // the count, not the array

// Wrong: $items = array_push($items, 'mug');  turns $items into int(4)
array_push($items, 'mug');   // right: call it on its own line
print_r($items);

array_unshift()와 true를 반환하는 sort()도 마찬가지입니다. 배열을 직접 바꾸는 함수는 배열이 아니라 상태를 돌려줍니다.