Variables Conceptos básicos En PHP las variables se representan con un signo de dólar seguido por el nombre de la variable. El nombre de la variable es sensible a minúsculas y mayúsculas. Un nombre de variable válido tiene que empezar con una letra (A-Z, a-z, o los bytes del 128 al 255) o un carácter de subrayado (underscore), seguido de cualquier número de letras, números y caracteres de subrayado. Como expresión regular se podría expresar como: ^[a-zA-Z_\x80-\xff][a-zA-Z0-9_\x80-\xff]*$ PHP no soporta Unicode en el nombre de las variables, sin embargo, algunas codificaciones de caracteres (como UTF-8) codifican caracteres de tal manera que todos los bytes de un carácter multibyte están dentro del rango permitido, convirtiéndolo así en un nombre de variable válido. $this es una variable especial que no puede ser asignada. Antes de PHP 7.1.0, era posible la asignación indirecta (por ejemplo, mediante el uso de variables variables). &tip.userlandnaming; Valid variable names ]]> Invalid variable names PHP acepta una secuencia de bytes como nombre de variable. Los nombres de variables que no siguen las reglas de nombres mencionadas anteriormente solo pueden accederse de forma dinámica en tiempo de ejecución. Consulte variables variables para obtener información sobre cómo acceder a ellas. Cómo acceder a nombres de variables con caracteres no válidos ]]> &example.outputs; Por omisión, las variables siempre se asignan por valor. Esto significa que cuando se asigna una expresión a una variable, el valor completo de la expresión original se copia en la variable de destino. Esto quiere decir que, por ejemplo, después de asignar el valor de una variable a otra, los cambios que se efectúen a una de esas variables no afectará a la otra. Para más información sobre este tipo de asignación, vea el capítulo sobre Expresiones. PHP también ofrece otra forma de asignar valores a las variables: asignar por referencia. Esto significa que la nueva variable simplemente referencia (en otras palabras, "se convierte en un alias de" ó "apunta a") la variable original. Los cambios a la nueva variable afectan a la original, y viceversa. Para asignar por referencia, simplemente se antepone un signo ampersand (&) al comienzo de la variable cuyo valor se está asignando (la variable fuente). Por ejemplo, el siguiente segmento de código produce la salida 'Mi nombre es Bob' dos veces: ]]> Algo importante a tener en cuenta es que sólo las variables con nombre pueden ser asignadas por referencia. ]]> No es necesario inicializar variables en PHP, sin embargo, es una muy buena práctica. El acceso a una variable no definida generará un E_WARNING (en versiones anteriores a PHP 8.0.0, E_NOTICE). Una variable no definida tiene un valor predeterminado de &null;. Se puede utilizar la construcción del lenguaje isset para detectar si una variable ya se ha inicializado. Valores predeterminados en variables sin inicializar ]]> &example.outputs; PHP permite la autovivificación de array (creación automática de un nuevo array) a partir de una variable no definida. Añadidiendo un elemento a una variable no definida creará un nuevo array y no producirá ninguna advertencia. Autovivification de un array a partir de una variable no definida ]]> Depender del valor predeterminado de una variable sin inicializar es problemático al incluir un archivo en otro que use el mismo nombre de variable. Una variable puede ser destruida, utilizando la construcción del lenguaje unset. Para información con funciones relativas a variables, mira la Referencia de funciones de variables. Variables Predefinidas PHP proporciona una gran cantidad de variables predefinidas. PHP ofrece un conjunto adicional de arrays predefinidas que contienen variables del servidor web (cuando es aplicable), el entorno y entradas del usuario. Estos arrays están automáticamente disponibles en cualquier entorno. Por esa razón, a veces son conocidas como "superglobales". (No existe mecanismo en PHP para crear superglobales definidas por el usuario). Referencia de la lista de superglobales para más detalles. Variables variables Las superglobales no pueden ser usadas como variables variables en el interior de funciones o métodos de clase. Si ciertas variables no son definidas en variables_order, los arrays de PHP predefinidos asociados a estas, estarán vacíos. Ámbito de las variables El ámbito de una variable es el contexto en el cual la variable está definida. PHP tiene un ámbito de función y un ámbito global. Cualquier variable difinida fuera de una función está limitada al ámbito global. Cuando se incluye un archivo, el código contenido hereda el ámbito de la variable de la línea en la cual se incluye el archivo. Ejemplo de una variable de ámbito global ]]> Cualquier variable declarada dentro de una función o una funcíón anónima está limitada al ámbito del cuerpo de dicha función. Sin embargo, las funciones de flecha vinculan las variables desde el ámbito padre haciendo que estén disponibles dentro de la función. Si se incluye un archivo dentro de una función, las variables contenidas en el archivo llamado estarán disponibles como si se hubieran definido dentro de la función que realiza la llamada. Ejemplo de una variable de ámbito local ]]> El ejemplo anterior producirá un E_WARNING por una variable no definida (o un E_NOTICE antes de PHP 8.0.0). Esto se debe a la expresión echo hace referencia a una versión local de la variable $a, a la cual no se le ha asignado un valor dentro de su ámbito. Puede que usted note que hay una pequeña diferencia con el lenguaje C, en el que las variables globales están disponibles automáticamente dentro de la función a menos que sean expresamente sobreescritas por una definición local. Esto puede causar algunos problemas, ya que la gente podría cambiar variables globales sin darse cuenta. En PHP, las variables globales deben ser declaradas globales dentro de la función si van a ser utilizadas dentro de dicha función. La palabra clave <literal>global</literal> La palabra clave global se usa para vincular una variable desde el ámbito global a un ámbito local. La palabra clave puede ser usada con una lista de variables o con una sola variable. Una variable local será creada haciendo referendia a una variable global con el mismo nombre. Si no existe la variable global, la variable será creada en el ámbito global y asignado el valor &null;. Uso de <literal>global</literal> ]]> &example.outputs; Al declarar las variables $a y $b globales dentro de la función, todas las referencias a tales variables se referirán a la versión global. No hay límite al número de variables globales que se pueden manipular dentro de una función. Un segundo método para acceder a las variables desde un ámbito global es usando el array especial definido por PHP $GLOBALS. El ejemplo anterior se puede reescribir así: Uso de <varname>$GLOBALS</varname> en lugar de global ]]> El array $GLOBALS es un array asociativo con el nombre de la variable global como clave y los contenidos de dicha variable como el valor del elemento del array. $GLOBALS existe en cualquier ámbito, esto ocurre ya que $GLOBALS es una superglobal. Aquí hay un ejemplo que demuestra el poder de las superglobales: Ejemplo que demuestra las superglobales y el ámbito ]]> Utilizar una clave global fuera de una función no es un error. Esta puede ser utilizada aún si el fichero está incluido desde el interior de una función. Uso de variables <literal>static</literal> Otra característica importante del ámbito de las variables es la variable estática. Una variable estática existe sólo en el ámbito local de la función, pero no pierde su valor cuando la ejecución del programa abandona este ámbito. Consideremos el siguiente ejemplo: Ejemplo que demuestra la necesidad de variables estáticas ]]> Esta función tiene poca utilidad ya que cada vez que es llamada asigna a $a el valor 0 e imprime un 0. La sentencia $a++, que incrementa la variable, no sirve para nada, ya que en cuanto la función finaliza, la variable $a desaparece. Para hacer una función útil para contar, que no pierda la pista del valor actual del conteo, la variable $a debe declararse como estática: Ejemplo del uso de variables estáticas ]]> Ahora, $a se inicializa únicamente en la primera llamada a la función, y cada vez que la función test() es llamada, imprimirá el valor de $a y lo incrementa. Las variables estáticas también proporcionan una forma de manejar funciones recursivas. La siguiente función cuenta recursivamente hasta 10, usando la variable estática $count para saber cuándo parar: Variables estáticas con funciones recursivas ]]> Antes de PHP 8.3.0, las variables estáticas solo podían ser inicializadas usando expresiones constantes. A partir de PHP 8.3.0, expresiones dinámicas (por ejemplo, llamadas a funciones) también están permitidas: Declarando variables estáticas ]]> Las variables estáticas dentro de funiones anónimas también persisten solo dentro de esa instancia específica de la función. Si la función anónima es recreada en cada llamada, la variable estática será reinicializada. Variables estáticas en funciones anónimas ]]> A partir de PHP 8.1.0, cuando un método que usa variables estáticas es heredado (pero no sobrescrito), el método heredado compartirá ahora las variables estáticas con el método padre. Esto significa que las variables estáticas en los métodos ahora se comportan de la misma manera que las propiedades estáticas. A partir de PHP 8.3.0, las variables estáticas pueden ser inicializadas con expresiones arbitrarias. Esto significa que las llamadas a métodos, por ejemplo, pueden ser usadas para inicializar variables estáticas. Uso de variables estáticas en métodos heredados ]]> Referencias con variables <literal>global</literal> y <literal>static</literal> PHP implementa los modificadores static y global para variables en términos de referencias. Por ejemplo, una variable global verdadera importada dentro del ámbito de una función con global crea una referencia a la variable global. Esto puede ser causa de un comportamiento inesperado, tal y como podemos comprobar en el siguiente ejemplo: ]]> &example.outputs; Un comportamiento similar se aplica a static. Las referencias no son almacenadas estáticamente. property)) { $obj->property = 1; } else { $obj->property++; } return $obj; } function &get_instance_noref() { static $obj; echo 'Objeto estático: '; var_dump($obj); if (!isset($obj)) { $new = new stdClass; // Asignar el objeto a la variable estática $obj = $new; } if (!isset($obj->property)) { $obj->property = 1; } else { $obj->property++; } return $obj; } $obj1 = get_instance_ref(); $aun_obj1 = get_instance_ref(); echo "\n"; $obj2 = get_instance_noref(); $aun_obj2 = get_instance_noref(); ?> ]]> &example.outputs; int(1) } ]]> Este ejemplo demuestra que al asignar una referencia a una variable estática, esta no es recordada cuando se invoca la funcion &obtener_instancia_ref() por segunda vez. Variables variables A veces es conveniente tener nombres de variables variables. Dicho de otro modo, son nombres de variables que se pueden definir y usar dinámicamente. Una variable normal se establece con una sentencia como: ]]> Una variable variable toma el valor de una variable y lo trata como el nombre de una variable. En el ejemplo anterior, hola, se puede usar como el nombre de una variable utilizando dos signos de dólar. Es decir: ]]> En este momento se han definido y almacenado dos variables en el árbol de símbolos de PHP: $a, que contiene "hola", y $hola, que contiene "mundo". Es más, esta sentencia: ]]> produce el mismo resultado que: ]]> esto quiere decir que ambas producen el resultado: hola mundo. Para usar variables variables con arrays hay que resolver un problema de ambigüedad. Si se escribe $$a[1], el intérprete necesita saber si nos referimos a utilizar $a[1] como una variable, o si se pretendía utilizar $$a como variable y el índice [1] como índice de dicha variable. La sintaxis para resolver esta ambigüedad es: ${$a[1]} para el primer caso y ${$a}[1] para el segundo. También se puede acceder a las propiedades de una clase usando el nombre de propiedad variable. Este será resuelto dentro del ámbito del cual se hizo la llamada. Por ejemplo, en la expresión $foo->$bar, se buscará $bar en el ámibto local y se empleará su valor será como el nombre de la propiedad de $foo. Esto también es cierto si $bar es un acceso a un array. También se pueden usar llaves para delimitar de forma clara el nombre de la propiedad. Son muy útila al acceder a valores dentro una propiedad que contiene un array, cuando el nombre de la propiedad está compuesto de múltiples partes, o cuando el nombre de la propiedad contiene caracteres que de otro modo no son válidos (p.ej. desde json_decode o SimpleXML). Ejemplo de propiedad variable $bar . "\n"; echo $foo->{$baz[1]} . "\n"; $start = 'b'; $end = 'ar'; echo $foo->{$start . $end} . "\n"; $arr = 'arr'; echo $foo->{$arr[1]} . "\n"; echo $foo->{$arr}[1] . "\n"; ?> ]]> &example.outputs; Soy bar. Soy bar. Soy bar. Soy r. Soy B. Por favor tenga en cuenta que las variables variables no pueden usarse con los Arrays superglobales de PHP al interior de funciones o métodos de clase. La variable $this es también una variable especial que no puede ser referenciada dinámicamente. Variables desde fuentes externas Formularios HTML (GET y POST) Cuando se envía un formulario a un script de PHP, la información de dicho formulario pasa a estar automáticamente disponible en el script. Existen algunas formas de acceder a esta información, por ejemplo: Un formulario HTML sencillo Nombre usuario:
Email:
]]>
Solamente existen dos maneras de acceder a datos desde formularios HTML. Los métodos disponibles actualmente se enumeran a continuación: Acceso a datos de un formulario HTML sencillo con POST ]]> Usar un formulario con GET es similar excepto en el uso de variables predefinidas, que en este caso serán del tipo GET. GET también se usa con QUERY_STRING (la información despues del símbolo '?' en una URL). Por ejemplo http://www.example.com/test.php?id=3 contiene datos GET que son accesibles con $_GET['id']. Véase también $_REQUEST. Puntos y espacios en nombres de variables son convertidos a guiones bajos. Por ejemplo <input name="a.b" /> se convierte en $_REQUEST["a_b"]. PHP también entiende arrays en el contexto de variables de formularios (vea la faq relacionada). Se puede, por ejemplo, agrupar juntas variables relacionadas o usar esta característica para obtener valores de una entrada "select" múltiple. Por ejemplo, vamos a mandar un formulario a sí mismo y a presentar los datos cuando se reciban: Variables de formulario más complejas '; echo htmlspecialchars(print_r($_POST, true)); echo ''; } ?>
Nombre:
Email:
Cerveza:

]]>
Si una variable externa comienza con una sintaxis de array válida, Los caracteres finales se ignoran en silencio. Por ejemplo, <input name="foo[bar]baz"> se convierte en $_REQUEST['foo']['bar']. Nombres de variables tipo IMAGE SUBMIT Cuando se envía un formulario, es posible usar una imagen en vez del botón estándar "submit": ]]> Cuando el usuario hace click en cualquier parte de la imagen, el formulario que la acompaña se transmitirá al servidor con dos variables adicionales, sub_x y sub_y. Éstas contienen las coordenadas del clic del usuario dentro de la imagen. Los más experimentados puede notar que los nombres de variable enviados por el navegador contienen un guión en vez de un subrayado (guión bajo), pero PHP convierte el guión en subrayado automáticamente.
Cookies HTTP PHP soporta cookies de HTTP de forma transparente tal y como están definidas en RFC 6265. Las cookies son un mecanismo para almacenar datos en el navegador y así rastrear o identificar a usuarios que vuelven. Se pueden crear cookies usando la función setcookie. Las cookies son parte de la cabecera HTTP, así que se debe llamar a la función SetCookie antes de que se envíe cualquier salida al navegador. Es la misma restricción que para la función header. Los datos de una cookie están disponibles en el array de datos de la cookies apropiada, tal como $_COOKIE y $_REQUEST. Véase la página de setcookie del manual para más detalles y ejemplos. A partir de PHP 7.2.34, 7.3.23 y 7.4.11, respectivamente, los nombres de las cookies entrantes ya no son con url-decoded por razones de seguridad. Si se quieren asignar múltiples valores a una sola cookie, basta con asignarlo como un array. Por ejemplo: ]]> Esto creará dos cookies separadas aunque MiCookie será un array simple en el script. Si se quiere definir una sola cookie con valores múltiples, considere el uso de la función serialize o explode primero en el valor. Nótese que una cookie reemplazará a una cookie anterior que tuviese el mismo nombre en el navegador a menos que la ruta o el dominio fuesen diferentes. Así, para una aplicación de carrito de compras se podría querer mantener un contador e ir pasándolo. Es decir: Un ejemplo de <function>setcookie</function> ]]> Puntos en los nombres de variables de entrada Típicamente, PHP no altera los nombres de las variables cuando se pasan a un script. Sin embargo, hay que notar que el punto no es un carácter válido en el nombre de una variable PHP. Para conocer la razón, considere el siguiente ejemplo: ]]> Lo que el intérprete vé es el nombre de una variable $varname, seguido por el operador de concatenación, y seguido por la cadena pura (es decir, una cadena sin entrecomillar que no coincide con ninguna palabra clave o reservada conocida) 'ext'. Obviamente, no se pretendía que fuese éste el resultado. Por esta razón, es importante hacer notar que PHP reemplazará automáticamente cualquier punto en los nombres de variables de entrada por guiones bajos (subrayados). Determinación de los tipos de variables Dado que PHP determina los tipos de las variables y los convierte (generalmente) según lo que necesita, no siempre resulta obvio de qué tipo es una variable dada en un momento concreto. PHP incluye varias funciones que descubren de qué tipo es una variable: gettype, is_array, is_float, is_int, is_object, y is_string. Vea también el capítulo sobre Tipos. Dado que HTTP es un protocolo de texto, la mayoría, si no todo, el contenido que llega en arrays superglobales, como $_POST y $_GET, permanecerá como cadenas de texto. PHP no intentará convertir los valores a un tipo específico. En el ejemplo siguiente, $_GET["var1"] contendrá la cadena "null" y $_GET["var2"], la cadena "123". &reftitle.changelog; &Version; &Description; 7.2.34, 7.3.23, 7.4.11 Los nombres de las cookies entrantes ya no son con url-decoded por razones de seguridad.