当前位置: 首页> 最新文章列表> 使用array_push向PHP数组添加元素的基本方法

使用array_push向PHP数组添加元素的基本方法

gitbox 2025-06-03

一、array_push() 是什么?

array_push() 是PHP内置函数,用于将一个或多个元素添加到一个数组的末尾。它的语法非常简单:

array_push(array &$array, mixed ...$values): int
  • $array 是目标数组,注意是以引用的方式传入。

  • $values 是要添加的一个或多个值。

  • 返回值是添加新元素后数组的总元素个数。

二、基本用法示例

我们来看一个最简单的例子:

<?php
$fruits = ["apple", "banana"];
array_push($fruits, "orange");
print_r($fruits);
?>

输出结果为:

Array
(
    [0] => apple
    [1] => banana
    [2] => orange
)

可以看到,"orange" 被添加到了数组 $fruits 的末尾。

三、添加多个元素

array_push() 支持一次添加多个元素,非常适合在需要批量添加时使用:

<?php
$numbers = [1, 2];
array_push($numbers, 3, 4, 5);
print_r($numbers);
?>

输出结果:

Array
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
    [4] => 5
)

四、与 [] 运算符的比较

你可能知道,PHP中也可以通过 [] 运算符添加元素:

$fruits[] = "grape";

这种方式在多数情况下和 array_push() 是等效的,但 array_push() 在需要添加多个元素时更加清晰。

例如,以下两种写法是等效的:

array_push($arr, "a", "b", "c");

等价于:

$arr[] = "a";
$arr[] = "b";
$arr[] = "c";

当你需要一次性添加多个元素时,使用 array_push() 可读性更好。

五、注意事项

  1. array_push() 只能将元素添加到数组末尾,无法指定插入位置。

  2. 它会修改原数组,因此不需要用返回值接收新的数组。

  3. 如果你在使用中遇到问题,可以访问 https://gitbox.net/php-array_push-doc 查看更详细的官方文档说明。