array_push() trong PHP: thêm phần tử vào mảng

array_push($arr, $value) thêm một giá trị vào cuối mảng. Với một giá trị duy nhất, cách viết tắt $arr[] = $value; làm cùng việc mà không cần gọi hàm, và đây là cách phần lớn code PHP sử dụng. Cả hai đều thay đổi trực tiếp mảng.

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

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

print_r($colors);

array_push() nhận mảng theo tham chiếu, nên nó thay đổi chính biến bạn truyền vào. Hàm trả về số phần tử mới, và bạn có thể bỏ qua giá trị này.

array_push vs $arr[] =

Dùng $arr[] = $value cho một giá trị: ngắn hơn và không phải gọi hàm, điều này cộng dồn lại đáng kể trong một vòng lặp lớn. Dùng array_push() khi bạn có nhiều giá trị cần thêm trong một câu lệnh, hoặc một danh sách giá trị cần spread vào.

<?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[] = cũng dùng được với một biến chưa tồn tại: PHP sẽ tạo mảng. array_push() cần một mảng có sẵn: với một biến chưa định nghĩa, hàm ném ra TypeError: array_push(): Argument #1 ($array) must be of type array, null given.

Thêm khóa và giá trị

array_push() chỉ nối thêm giá trị với khóa số nguyên kế tiếp. Để thêm một khóa có tên, hãy gán trực tiếp vào khóa đó. Để thêm nhiều cặp cùng lúc, dùng += (giữ các khóa đã có) hoặc array_merge() (để giá trị mới thắng).

<?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);

Sự khác biệt giữa + và array_merge() khi trùng khóa được trình bày ở trang array_merge.

Thêm vào đầu mảng: array_unshift

array_unshift($arr, $value) chèn vào đầu mảng. Các khóa số nguyên được đánh số lại để giá trị mới nhận chỉ số 0; khóa chuỗi được giữ nguyên. Giống array_push(), hàm này nhận nhiều giá trị và trả về số phần tử mới.

<?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);

Để đặt một cặp có tên lên đầu, hãy tạo một mảng mới: $menu = ['login' => '/login'] + $menu;.

Chèn vào một vị trí cụ thể

array_splice($arr, $offset, 0, $values) chèn mà không xóa gì: nó bắt đầu tại $offset, xóa 0 phần tử và đặt các giá trị mới vào đó. Các khóa số nguyên sau điểm chèn được đánh số lại.

<?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() còn có thể xóa và thay thế phần tử; trang về cách xóa phần tử trình bày các dạng đó.

Nối thêm một mảng khác

array_push($a, $b) thêm $b thành một phần tử lồng nhau duy nhất, hiếm khi là điều bạn muốn. Để thêm lần lượt từng giá trị của $b, hãy spread chúng, hoặc tạo một mảng mới bằng cú pháp spread hay 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";

Lỗi thường gặp: gán giá trị trả về

array_push() trả về một con số, là số phần tử mới. Gán số đó ngược lại cho biến mảng sẽ thay mảng của bạn bằng một số nguyên, và lần array_push() tiếp theo trên biến đó sẽ ném ra 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);

Điều tương tự cũng đúng với array_unshift() và với sort(), hàm trả về true. Những hàm thay đổi trực tiếp mảng trả về một trạng thái, không phải mảng.