Errores al verificar si un array es asociativo en PHP

Cómo verificar si un array es asociativo o secuencial en PHP: errores comunes

¿Alguna vez escribiste un foreach y obtuviste algo inesperado? ¿O pasaste un array a una función que esperaba una lista, pero recibió un array asociativo con claves de tipo string? Si es así, no estás solo. La pregunta «How to check if PHP array is associative or sequential?» está entre las más populares en Stack Overflow con miles de visitas. Y no es casualidad: la confusión entre tipos de arrays es una de las principales trampas para los desarrolladores de PHP.

En este artículo, analizaremos las diferencias entre arrays asociativos y secuenciales, mostraremos errores frecuentes y daremos soluciones prácticas. ¡Empecemos!

¿Qué es un array secuencial y uno asociativo?

En PHP no existe una separación estricta entre «listas» y «diccionarios», como en Python o JavaScript. Un solo tipo, array, puede ser ambos. Pero en la práctica, es importante entender la diferencia:

\n
• Array secuencial (sequential) — las claves van en orden: 0, 1, 2, 3... sin saltos. Ejemplo: ['manzana', 'pera', 'cereza'].
\n
• Array asociativo — las claves son strings o números fuera de orden. Ejemplo: ['nombre' => 'Juan', 'edad' => 30].
\n

Parece sencillo, pero en la práctica los desarrolladores suelen equivocarse al intentar determinar el tipo de array manualmente. Analicemos los errores más comunes.

Error común #1: Usar array_keys() y comparar con range

Uno de los enfoques más extendidos es tomar las claves del array, generar una secuencia de 0 a count($array)-1 y compararlas. Parece lógico, pero tiene matices.

// Ejemplo de enfoque incorrecto\nfunction isSequential($arr) {\n    return array_keys($arr) === range(0, count($arr) - 1);\n}\n\n$test = ['a', 'b', 'c'];\nvar_dump(isSequential($test)); // true — correcto\n\n$test2 = ['x' => 1, 'y' => 2];\nvar_dump(isSequential($test2)); // false — correcto\n\n$test3 = [0 => 'a', 2 => 'b'];\nvar_dump(isSequential($test3)); // false — correcto\n\n$test4 = ['0' => 'a', '1' => 'b'];\nvar_dump(isSequential($test4)); // ??? \n

El problema es que PHP convierte automáticamente las claves de tipo string a enteros si parecen números. ['0' => 'a', '1' => 'b'] es en realidad un array secuencial, pero nuestra función puede dar un resultado inesperado debido a la comparación estricta (===).

Conclusión: este enfoque funciona, pero solo si estás seguro de los tipos de las claves. Para producción, es mejor usar métodos más robustos.

Error común #2: Verificar solo la primera clave

Algunos desarrolladores piensan: «Si la primera clave es 0, entonces el array es secuencial». Esto es una creencia peligrosa.

function isSequentialByFirstKey($arr) {\n    if (empty($arr)) return true;\n    return array_key_first($arr) === 0;\n}\n\n$bad = [0 => 'a', 'name' => 'Juan'];\nvar_dump(isSequentialByFirstKey($bad)); // true — ¡pero debería ser false!\n

La primera clave es 0, pero el array es claramente asociativo. Esta verificación pasará por alto arrays mixtos, que son comunes en proyectos reales.

Conclusión: nunca juzgues un array por su primer elemento. Verifica todas las claves.

Error común #3: Ignorar arrays vacíos

Un array vacío [] — ¿es secuencial y asociativo a la vez? Desde el punto de vista de PHP, sí. Pero algunas funciones fallan.

function isAssociative($arr) {\n    return count(array_filter(array_keys($arr), 'is_string')) > 0;\n}\n\nvar_dump(isAssociative([])); // false — el array vacío no es asociativo\nvar_dump(isAssociative([1, 2, 3])); // false — correcto\n

Parece lógico, pero si esperas que la función devuelva true para un array vacío (como si fuera asociativo), te equivocas. Un array vacío es un caso especial.