array push PHP

array_push en PHP: añadir valores y conservar las claves

Añade uno o varios valores a un array PHP y distingue el número de elementos de la última clave.

Tipo: Guía práctica Lectura: 3 min Actualizado: 2026-11-03
Ejemplo visual para array_push en PHP: añadir elementos sin perder claridad

Guía y comprobaciones

Añadir no es asignar el resultado

array_push modifica el array recibido y devuelve su nueva cantidad de elementos. Si escribes $lista = array_push(...), sustituyes la lista por un entero. Para un solo valor, $lista[] = $valor expresa directamente la operación; para varios, array_push($lista, $a, $b) permite agruparla.

$cola = ['revisar'];
$cantidad = array_push($cola, 'probar', 'publicar');
echo json_encode($cola), PHP_EOL;
echo $cantidad, PHP_EOL;
// ["revisar","probar","publicar"]
// 3

Claves numéricas y asociativas

Un array PHP es un mapa ordenado. Añadir con corchetes crea una clave numérica: no sustituye una clave de texto como estado. Si la última clave numérica es 7, el siguiente elemento normalmente tendrá clave 8, aunque sólo haya dos elementos. Por eso count y la próxima clave no representan lo mismo.

$datos = [7 => 'inicial', 'estado' => 'abierto'];
$datos[] = 'siguiente';
echo $datos[8], PHP_EOL; // siguiente
echo count($datos), PHP_EOL; // 3

Para añadir un campo con nombre usa $datos['autor'] = 'Ana'. Para incorporar una lista, elige si quieres un elemento que contenga otra lista o varios elementos individuales: array_push($cola, ['a', 'b']) crea un array anidado, mientras array_push($cola, ...['a', 'b']) añade dos valores.

Evitar cambios sorprendentes

Inicializa la variable como array antes de utilizarla. Que un formulario envíe un campo con el nombre esperado no garantiza que su tipo sea correcto: comprueba is_array si vas a tratar datos externos. Si buscas una cola sin duplicados, añadir no elimina repeticiones; decide una clave de identidad o comprueba la pertenencia con comparación estricta. Una cola de trabajos también necesita persistencia y control de concurrencia: este ejemplo sólo organiza valores en memoria.

Preguntas frecuentes

¿array_push devuelve el array?

Devuelve la nueva cantidad de elementos; la variable pasada se modifica directamente.

¿Cómo añado una clave de texto?

Asigna el valor con su clave, por ejemplo $datos['estado'] = 'cerrado'. Añadir con [] o array_push crea claves numéricas.

Documentación oficial

Fuentes consultadas

Fuentes y referencias

Consulta referencias útiles para ampliar o contrastar esta guía.

R

Autora de la guia

Redacción de Línea de Código

Publicación independiente de programación y trámites digitales

Guías con ejemplos y referencias oficiales para aprender programación y preparar gestiones digitales. Las solicitudes se completan en el organismo responsable.

Actualizado: 2026-11-03 Politica editorial Correcciones

Por que confiar

Contrastamos fuentes oficiales, actualizamos piezas clave y priorizamos estructura, contexto y enlazado interno por encima del relleno.

Compartir

Guarda o comparte esta guia con el enlace limpio.