Constantes

Constantes#

Una constante es un identificador (nombre) para un valor simple. Como su nombre sugiere, ese valor no puede cambiar durante la ejecución del script (excepto las constantes mágicas, que en realidad no son constantes). Las constantes distinguen entre mayúsculas y minúsculas. Por convención, los identificadores de constantes se escriben siempre en mayúsculas.

[!NOTE] Antes de PHP 8.0.0, las constantes definidas con la función define podían no distinguir entre mayúsculas y minúsculas.

El nombre de una constante sigue las mismas reglas que cualquier etiqueta en PHP. Un nombre de constante válido comienza con una letra o guion bajo, seguido de cualquier cantidad de letras, números o guiones bajos. Como expresión regular, se expresaría así: ^[a-zA-Z_\x80-\xff][a-zA-Z0-9_\x80-\xff]*$

Es posible definir constantes con define usando nombres reservados o incluso inválidos, cuyo valor solo puede obtenerse con la función constant. Sin embargo, no se recomienda hacerlo.

[!TIP] Véase también ???.

Nombres de constantes válidos e inválidos

<?php

// Nombres de constantes válidos
define("FOO",     "something");
define("FOO2",    "something else");
define("FOO_BAR", "something more");

// Nombres de constantes inválidos
define("2FOO",    "something");

// Esto es válido, pero debe evitarse:
// PHP podría algún día proporcionar una constante mágica
// que rompa el script
define("__FOO__", "something");

[!NOTE] Para estos propósitos, una letra es a-z, A-Z y los caracteres ASCII del 128 al 255 (0x80-0xff).

Al igual que las superglobals, el ámbito de una constante es global. Las constantes pueden ser accedidas desde cualquier lugar del script sin importar el ámbito. Para más información sobre el ámbito, consulte la sección del manual sobre ámbito de las variables.

[!NOTE] A partir de PHP 7.1.0, las constantes de clase pueden declarar una visibilidad protected o private, haciéndolas disponibles únicamente en el ámbito jerárquico de la clase en la que se definen.

Sintaxis#

Las constantes pueden definirse usando la palabra clave const o usando la función define. Mientras que define permite definir una constante con una expresión arbitraria, la palabra clave const tiene restricciones como se describe en el siguiente párrafo. Una vez definida, una constante no puede ser modificada ni eliminada.

Al usar la palabra clave const, solo se aceptan expresiones escalares (bool, int, float y string) y arrays constantes que contengan únicamente expresiones escalares. Es posible definir constantes como resource, pero debe evitarse, ya que puede causar resultados inesperados.

El valor de una constante se obtiene simplemente especificando su nombre. A diferencia de las variables, una constante no va precedida de un signo $. También es posible usar la función constant para leer el valor de una constante si su nombre se obtiene dinámicamente. Use get_defined_constants para obtener una lista de todas las constantes definidas.

[!NOTE] Las constantes y las variables (globales) se encuentran en espacios de nombres diferentes. Esto implica que, por ejemplo, true y $TRUE son generalmente diferentes.

Si se usa una constante no definida, se lanza un Error. Antes de PHP 8.0.0, las constantes no definidas se interpretaban como una cadena (string) sin comillas, es decir (CONSTANT vs "CONSTANT"). Este comportamiento está obsoleto desde PHP 7.2.0, y se emite un error de nivel E_WARNING cuando ocurre. Antes de PHP 7.2.0, se emitía un error de nivel E_NOTICE. Consulte también la entrada del manual sobre por qué \$foo[bar] es incorrecto (a menos que bar sea una constante). Esto no se aplica a las constantes (totalmente) cualificadas, que siempre lanzarán un Error si no están definidas.

[!NOTE] Para comprobar si una constante está definida, use la función defined.

Estas son las diferencias entre constantes y variables:

• Las constantes no llevan el signo de dólar ($) delante;

• Las constantes pueden definirse y accederse desde cualquier lugar sin importar las reglas de ámbito de las variables;

• Las constantes no pueden redefinirse ni eliminarse una vez establecidas; y

• Las constantes solo pueden evaluarse a valores escalares o arrays.

Definición de constantes

<?php
define("CONSTANT", "Hello world.");
echo CONSTANT; // muestra "Hello world."
echo Constant; // Lanza un Error: Undefined constant "Constant"
               // Antes de PHP 8.0.0, muestra "Constant" y emite una advertencia.

Definición de constantes usando la palabra clave const

<?php
// Valor escalar simple
const CONSTANT = 'Hello World';

echo CONSTANT . "\n";

// Expresión escalar
const ANOTHER_CONST = CONSTANT . '; Goodbye World';
echo ANOTHER_CONST . "\n";

const ANIMALS = array('dog', 'cat', 'bird');
echo ANIMALS[1] . "\n"; // muestra "cat"

// Arrays constantes
define('ANIMALS_DEF', array(
    'dog',
    'cat',
    'bird'
));
echo ANIMALS_DEF[1] . "\n"; // muestra "cat"

[!NOTE] A diferencia de la definición de constantes con define, las constantes definidas con la palabra clave const deben declararse en el ámbito de nivel superior porque se definen en tiempo de compilación. Esto significa que no pueden declararse dentro de funciones, bucles, instrucciones if o bloques try/catch.

Véase también#

Constantes de clase

Constantes predefinidas#

PHP proporciona un gran número de constantes predefinidas a cualquier script que ejecuta. Muchas de estas constantes, sin embargo, son creadas por diversas extensiones, y solo estarán presentes cuando esas extensiones estén disponibles, ya sea mediante carga dinámica o porque se han compilado con PHP.

Constantes mágicas#

Existen varias constantes mágicas que cambian dependiendo de dónde se utilicen. Por ejemplo, el valor de __LINE__ depende de la línea en la que se use en el script. Todas estas constantes "mágicas" se resuelven en tiempo de compilación, a diferencia de las constantes regulares, que se resuelven en tiempo de ejecución. Estas constantes especiales no distinguen entre mayúsculas y minúsculas y son las siguientes:

Constantes mágicas de PHP

Véase también#

::class, get_class, get_object_vars, file_exists, function_exists