大网数据广告活动
PHP 语言与运行手册

array_push · 将一个或多个单元压入数组的末尾(入栈)

· 52CE 我爱测

array_push() 将 array 当成一个栈,并将传入的变量压入 array 的末尾。array 的长度将根据入栈变量的数目增加。和如下效果相同: <?php $array[] = $var; ?> 并对每个传入的值重复以上动作。

array_push

(PHP 4, PHP 5, PHP 7, PHP 8)

array_push — 将一个或多个单元压入数组的末尾(入栈)

说明

function array_push(array &$array, mixed $value1, mixed $... = ?): int

array_push() 将 array 当成一个栈,并将传入的变量压入 array 的末尾。array 的长度将根据入栈变量的数目增加。和如下效果相同:

<?php
$array[] = $var;
?>
并对每个传入的值重复以上动作。

注意:

如果用 array_push() 来给数组增加一个单元,还不如用 $array[] = ,因为这样没有调用函数的额外负担。

注意:

如果第一个参数不是数组,array_push() 将发出一条警告。这和 $var[] 的行为不同,在 PHP 7.1.0 之前的版本中,后者将会新建一个数组。

参数

array

输入的数组。

value1

要压入 array 末尾的第一个值。

返回值

返回处理之后数组的元素个数。

更新日志

版本 说明
7.3.0 可以只用一个参数来调用此函数,之前版本中至少需要两个参数。

示例

示例 #1 array_push() 例子

<?php
$stack = array("orange", "banana");
array_push($stack, "apple", "raspberry");
print_r($stack);
?>

以上示例会输出:

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

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。