PHP array_push() 函数

封面图 • 2025-11-07 • PHP

`array_push()` 是 PHP 中用于向数组的末尾添加一个或多个元素的函数。它会**修改原数组**，并返回数组中元素的总数。

---

### ✅ 语法：

```php
int array_push(array &$array, mixed $value1, [mixed $value2 = ...])
```

- `$array`：要操作的数组（必须是引用传递）。
- `$value1, $value2, ...`：要添加到数组中的一个或多个值。

---

### 📌 示例：

```php
<?php
$fruits = ["apple", "banana"];

// 添加一个元素
array_push($fruits, "orange");

// 添加多个元素
array_push($fruits, "grape", "mango");

print_r($fruits);
?>
```

**输出：**

```
Array
(
    [0] => apple
    [1] => banana
    [2] => orange
    [3] => grape
    [4] => mango
)
```

---

### ⚠️ 注意事项：

1. **必须使用引用传递**：`array_push()` 的第一个参数是通过引用传递的，所以不能直接传入一个表达式，比如 `array_push($arr + [1,2], 3);` 这样是错误的。

❌ 错误写法：
   ```php
   array_push($arr + [1, 2], 3); // 错误！
   ```

✅ 正确写法：
   ```php
   $arr = [1, 2];
   array_push($arr, 3);
   ```

2. **返回值**：返回数组中元素的总数（即新长度）。

```php
   $count = array_push($fruits, "pear");
   echo $count; // 输出 5
   ```

3. **与 `[]` 操作符的区别**：
   - `array_push()` 可以一次添加多个元素。
   - 使用 `[]` 只能逐个添加元素。

```php
   $arr = [1, 2];
   $arr[] = 3; // 添加一个元素
   array_push($arr, 4, 5); // 添加多个元素
   ```

---

### 🔁 与 `array_unshift()` 对比：

| 函数           | 功能                     | 添加位置 |
|----------------|--------------------------|----------|
| `array_push()` | 向数组末尾添加元素       | 末尾     |
| `array_unshift()` | 向数组开头添加元素     | 开头     |

---

### ✅ 总结：

- `array_push()` 是一个非常实用的函数，用于在数组末尾追加一个或多个元素。
- 它会直接修改原始数组。
- 如果你需要一次添加多个元素，它是比多次使用 `$array[] = ...` 更简洁的方式。

如需了解更多数组函数，可以查看 PHP 官方文档：[https://www.php.net/manual/zh/function.array-push.php](https://www.php.net/manual/zh/function.array-push.php)