Un array en PHP es en realidad un mapa ordenado. Un mapa es un tipo de datos que asocia valores con claves. Este tipo se optimiza para varios usos diferentes; se puede emplear como un array, lista (vector), tabla asociativa (tabla hash - una implementación de un mapa), diccionario, colección, pila, cola, y posiblemente más. Ya que los valores de un array pueden ser otros arrays, también son posibles árboles y arrays multidimensionales. Una explicación sobre tales estructuras de datos está fuera del alcance de este manual, aunque se proporciona al menos un ejemplo de cada uno de ellos. Para más información, consulte la extensa literatura que existe sobre este amplio tema. Un array puede ser creado con el constructor del lenguaje array. Éste toma cualquier número de parejas clave => valor como argumentos. array( clave => valor, clave2 => valor2, clave3 => valor3, ... ) La coma después del último elemento del array es opcional, pudiéndose omitir. Esto normalmente se hace para arrays de una única línea, es decir, es preferible array(1, 2) que array(1, 2, ). Por otra parte, para arrays multilínea, la coma final se usa frecuentemente, ya que permite una adición más sencilla de nuevos elementos al final. A partir de PHP 5.4 también se puede usar la sintaxis de array corta, la cual reemplaza array() con []. "bar", "bar" => "foo", ); // a partir de PHP 5.4 $array = [ "foo" => "bar", "bar" => "foo", ]; ?> ]]> La clave puede ser un integer o un string. El valor puede ser de cualquier tipo. Además, se darán los siguientes amoldamientos de clave: Un strings que contenga un integer válido será amoldado al tipo integer. P.ej. la clave "8" en realidad será almacenada como 8. Por otro lado "08" no será convertido, ya que no es un número integer decimal válido. Un floats también será amoldado a integer, lo que significa que la parte fraccionaria se elimina. P.ej., la clave 8.7 en realidad será almacenada como 8. Un booleano son amoldados a integers también, es decir, la clave true en realidad será almacenada como 1 y la clave false como 0. Un null será amoldado a un string vacío, es decir, la clave null en realidad será almacenada como "". Los arrays y los objects no pueden utilizarse como claves. Si se hace, dará lugar a una advertencia: Illegal offset type. Si varios elementos en la declaración del array usan la misma clave, sólo se utilizará la última, siendo los demás son sobrescritos. "a", "1" => "b", 1.5 => "c", true => "d", ); var_dump($array); ?> ]]> &example.outputs; string(1) "d" } ]]> Como todas las claves en el ejemplo anterior se convierten en 1, los valores serán sobrescritos en cada nuevo elemento, por lo que el último valor asignado "d" es el único que queda. Los arrays de PHP pueden contener claves integer y string al mismo tiempo ya que PHP no distingue entre arrays indexados y asociativos. "bar", "bar" => "foo", 100 => -100, -100 => 100, ); var_dump($array); ?> ]]> &example.outputs; string(3) "bar" ["bar"]=> string(3) "foo" [100]=> int(-100) [-100]=> int(100) } ]]> La clave es opcional. Si no se especifica, PHP usará el incremento de la clave de tipo integer mayor utilizada anteriormente. ]]> &example.outputs; string(3) "foo" [1]=> string(3) "bar" [2]=> string(5) "hello" [3]=> string(5) "world" } ]]> Es posible especificar la clave sólo para algunos elementos y excluir a los demás: "c", "d", ); var_dump($array); ?> ]]> &example.outputs; string(1) "a" [1]=> string(1) "b" [6]=> string(1) "c" [7]=> string(1) "d" } ]]> Como se puede ver, al último valor "d" se le asignó la clave 7. Esto es debido a que la mayor clave integer anterior era 6. Los elementos de array se pueden acceder utilizando la sintaxis array[key]. "bar", 42 => 24, "multi" => array( "dimensional" => array( "array" => "foo" ) ) ); var_dump($array["foo"]); var_dump($array[42]); var_dump($array["multi"]["dimensional"]["array"]); ?> ]]> &example.outputs; Tanto los corchetes como las llaves pueden ser utilizados de forma intercambiable para acceder a los elementos de un array (p.ej.: $array[42] y $array{42} tendrán el mismo resultado en el ejemplo anterior). A partir de PHP 5.4 es posible hacer referencia al array del resultado de una llamada a una función o método directamente. Antes sólo era posible utilizando una variable temporal. Desde PHP 5.5 es posible hacer referencia directa un elemento de un array literal. ]]> Intentar acceder a una clave de un array que no se ha definido es lo mismo que el acceder a cualquier otra variable no definida: se emitirá un mensaje de error de nivel E_NOTICE, y el resultado será &null;. Un array existente puede ser modificado estableciendo explícitamente valores en él. Esto se realiza asignando valores al array, especificando la clave entre corchetes. Esta también se puede omitir, resultando en un par de corchetes vacíos ([]). $arr[clave] = valor; $arr[] = valor; // clave puede ser un integer o un string // valor puede ser cualquier valor de cualquier tipo Si $arr aún no existe, se creará, siendo también esta forma una alternativa de crear un array. Sin embargo, se desaconsejada esta práctica porque que si $arr ya contiene algún valor (p.ej. un string de una variable de petición), este estará en su lugar y [] puede significar realmente el operador de acceso a cadenas. Siempre es mejor inicializar variables mediante una asignación directa. Para cambiar un valor determinado se debe asignar un nuevo valor a ese elemento empleando su clave. Para quitar una pareja clave/valor, se debe llamar a la función unset con éste. 1, 12 => 2); $arr[] = 56; // Esto es lo mismo que $arr[13] = 56; // en este punto de el script $arr["x"] = 42; // Esto agrega un nuevo elemento a // el array con la clave "x" unset($arr[5]); // Esto elimina el elemento del array unset($arr); // Esto elimina el array completo ?> ]]> Como se mencionó anteriormente, si no se especifica una clave, se toma el máximo de los índices integer existentes, y la nueva clave será ese valor máximo más 1 (aunque al menos 0). Si todavía no existen índices integer, la clave será 0 (cero). Tenga en cuenta que la clave integer máxima utilizada para éste no es necesario que actualmente exista en el array. Ésta sólo debe haber existido en el array en algún momento desde la última vez que el array fué re-indexado. El siguiente ejemplo ilustra este comportamiento: $value) { unset($array[$i]); } print_r($array); // Agregar un elemento (note que la nueva clave es 5, en lugar de 0). $array[] = 6; print_r($array); // Re-indexar: $array = array_values($array); $array[] = 7; print_r($array); ?> ]]> &example.outputs; 1 [1] => 2 [2] => 3 [3] => 4 [4] => 5 ) Array ( ) Array ( [5] => 6 ) Array ( [0] => 6 [1] => 7 ) ]]> Hay un buen número de funciones útiles para trabajar con arrays. Véase la sección funciones de array. La función unset permite remover claves de un array. Tenga en cuenta que el array no es re-indexado. Si se desea un verdadero comportamiento "eliminar y desplazar", el array puede ser re-indexado usando la función array_values. 'uno', 2 => 'dos', 3 => 'tres'); unset($a[2]); /* producirá un array que se ha definido como $a = array(1 => 'uno', 3 => 'tres'); y NO $a = array(1 => 'uno', 2 =>'tres'); */ $b = array_values($a); // Ahora $b es array(0 => 'uno', 1 =>'tres') ?> ]]> La estructura de control &foreach; existe específicamente para arrays. Ésta provee una manera fácil de recorrer un array. Siempre deben usarse comillas alrededor de un índice de array tipo string literal. Por ejemplo, $foo['bar'] es correcto, mientras que $foo[bar] no lo es. ¿Pero por qué? Es común encontrar este tipo de sintaxis en scripts viejos: ]]> Esto está mal, pero funciona. La razón es que este código tiene una constante indefinida (bar) en lugar de un string ('bar' - observe las comillas). Puede que en el futuro PHP defina constantes que, desafortunadamente para tales tipo de código, tengan el mismo nombre. Funciona porque PHP automáticamente convierte un string puro (un string sin comillas que no corresponde con ningún símbolo conocido) en un string que contiene el string puro. Por ejemplo, si no se ha definido una constante llamada bar, entonces PHP reemplazará su valor por el string 'bar' y usará éste último. Esto no quiere decir que siempre haya que usar comillas en la clave. No use comillas con claves que sean constantes o variables, ya que en tal caso PHP no podrá interpretar sus valores. ]]> &example.outputs; Más ejemplos para demostrar este comportamiento: 'apple', 'veggie' => 'carrot'); // Correcto print $arr['fruit']; // apple print $arr['veggie']; // carrot // Incorrecto. Esto funciona pero también genera un error de PHP de // nivel E_NOTICE ya que no hay definida una constante llamada fruit // // Notice: Use of undefined constant fruit - assumed 'fruit' in... print $arr[fruit]; // apple // Esto define una constante para demostrar lo que pasa. El valor 'veggie' // es asignado a una constante llamada fruit. define('fruit', 'veggie'); // Note la diferencia ahora print $arr['fruit']; // apple print $arr[fruit]; // carrot // Lo siguiente está bien ya que se encuentra al interior de una cadena. Las constantes no son procesadas al // interior de cadenas, así que no se produce un error E_NOTICE aquí print "Hello $arr[fruit]"; // Hello apple // Con una excepción, los corchetes que rodean las matrices al // interior de cadenas permiten el uso de constantes print "Hello {$arr[fruit]}"; // Hello carrot print "Hello {$arr['fruit']}"; // Hello apple // Esto no funciona, resulta en un error de intérprete como: // Parse error: parse error, expecting T_STRING' or T_VARIABLE' or T_NUM_STRING' // Esto por supuesto se aplica también al uso de superglobales en cadenas print "Hello $arr['fruit']"; print "Hello $_GET['foo']"; // La concatenación es otra opción print "Hello " . $arr['fruit']; // Hello apple ?> ]]> Cuando se habilita error_reporting para mostrar errores de nivel E_NOTICE (como por ejemplo definiendo el valor E_ALL), este tipo de usos serán inmediatamente visibles. Por omisión, error_reporting se encuentra configurado para no mostrarlos. Tal y como se indica en la sección de sintaxis, lo que existe entre los corchetes cuadrados ('[' y ']') debe ser una expresión. Esto quiere decir que código como el siguiente funciona: ]]> Este es un ejemplo del uso de un valor devuelto por una función como índice del array. PHP también conoce las constantes: ]]> Note que E_ERROR es también un identificador válido, asi como bar en el primer ejemplo. Pero el último ejemplo es equivalente a escribir: ]]> ya que E_ERROR es igual a 1, etc. En algún momento en el futuro, puede que el equipo de PHP quiera usar otra constante o palabra clave, o una constante proveniente de otro código puede interferir. Por ejemplo, en este momento no puede usar las palabras empty y default de esta forma, ya que son palabras clave reservadas. Reiterando, al interior de un valor string entre comillas dobles, es válido no rodear los índices de array con comillas, así que "$foo[bar]" es válido. Consulte los ejemplos anteriores para más detalles sobre el porqué, así como la sección sobre procesamiento de variables en cadenas. Para cualquiera de los tipos: integer, float, string, boolean y resource, convertir un valor a un array resulta en un array con un solo elemento, con índice 0, y el valor del escalar que fue convertido. En otras palabras, (array)$scalarValue es exactamente lo mismo que array($scalarValue). Si convierte un object a un array, el resultado es un array cuyos elementos son las propiedades del object. Las claves son los nombres de las variables miembro, con algunas excepciones notables: las variables privadas tienen el nombre de la clase al comienzo del nombre de la variable; las variables protegidas tienen un caracter '*' al comienzo del nombre de la variable. Estos valores adicionados al inicio tienen bytes nulos a los lados. Esto puede resultar en algunos comportamientos inesperados: ]]> En el ejemplo anterior parecerá que se tienen dos claves llamadas 'AA', aunque en realidad una de ellas se llama '\0A\0A'. Si convierte un valor &null; a array, obtiene un array vacío. Es posible comparar arrays con la función array_diff y mediante operadores de arrays. El tipo array en PHP es bastante versátil. Aquí hay algunos ejempos: 'red', 'taste' => 'sweet', 'shape' => 'round', 'name' => 'apple', 4 // la clave será 0 ); $b = array('a', 'b', 'c'); // . . .es completamente equivalente a $a = array(); $a['color'] = 'red'; $a['taste'] = 'sweet'; $a['shape'] = 'round'; $a['name'] = 'apple'; $a[] = 4; // la clave será 0 $b = array(); $b[] = 'a'; $b[] = 'b'; $b[] = 'c'; // Después de que se ejecute el código, $a será el array // array('color' => 'red', 'taste' => 'sweet', 'shape' => 'round', // 'name' => 'apple', 0 => 4), y $b será el array // array(0 => 'a', 1 => 'b', 2 => 'c'), o simplemente array('a', 'b', 'c'). ?> ]]> 4, 'OS' => 'Linux', 'lang' => 'english', 'short_tags' => true ); // Keys estrictamente numéricas $array = array( 7, 8, 0, 156, -10 ); // esto es lo mismo que array(0 => 7, 1 => 8, ...) $switching = array( 10, // key = 0 5 => 6, 3 => 7, 'a' => 4, 11, // key = 6 (el índice entero máximo era 5) '8' => 2, // key = 8 (integer!) '02' => 77, // key = '02' 0 => 12 // el valor 10 será reemplazado por 12 ); // array vacío $empty = array(); ?> ]]> ]]> &example.outputs; Modificar los valores del array directamente es posible a partir de PHP 5, pasándolos por referencia. Las versiones anteriores necesitan una solución alternativa: $color) { $colors[$key] = strtoupper($color); } print_r($colors); ?> ]]> &example.outputs; ROJO [1] => AZUL [2] => VERDE [3] => AMARILLO ) ]]> Este ejemplo crea un array con base uno. 'Enero', 'Febrero', 'Marzo'); print_r($firstquarter); ?> ]]> &example.outputs; 'Enero' [2] => 'Febrero' [3] => 'Marzo' ) ]]> ]]> Los Arrays son ordenados. El orden puede ser modificado usando varias funciones de ordenado. Vea la sección sobre funciones de arrays para más información. La función count puede ser usada para contar el número de elementos en un array. ]]> Dado que el valor de un array puede ser cualquier cosa, también puede ser otro array. De esta forma es posible crear arrays recursivas y multi-dimensionales. array ( "a" => "orange", "b" => "banana", "c" => "apple" ), "numbers" => array ( 1, 2, 3, 4, 5, 6 ), "holes" => array ( "first", 5 => "second", "third" ) ); // Algunos ejemplos que hacen referencia a los valores del array anterior echo $fruits["holes"][5]; // prints "second" echo $fruits["fruits"]["a"]; // prints "orange" unset($fruits["holes"][0]); // remove "first" // Crear una nueva array multi-dimensional $juices["apple"]["green"] = "good"; ?> ]]> La asignación de arrays siempre involucra la copia de valores. Use el operador de referencia para copiar un array por referencia. ]]>