array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.define.php', 1 => 'define', 2 => 'Define una constante', ), 'up' => array ( 0 => 'ref.misc.php', 1 => 'Funciones Varias', ), 'prev' => array ( 0 => 'function.constant.php', 1 => 'constant', ), 'next' => array ( 0 => 'function.defined.php', 1 => 'defined', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/misc/functions/define.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

define

(PHP 4, PHP 5, PHP 7, PHP 8)

define — Define una constante

Descripción

function define(string $constant_name, mixed $value, bool $case_insensitive = false): bool

Define una constante durante la ejecución.

Parámetros

constant_name

El nombre de la constante.

Nota:

Es posible definir con define() constantes con nombres reservados o incluso inválidos, donde sus valores pueden (solo) ser recuperados con la función constant(). Sin embargo, hacer esto no se recomienda.

define() toma el nombre como un string ordinario y no lo resuelve con respecto al espacio de nombres actual. Dentro de namespace Mi\Espacio;, define('MICONSTANTE', 1) define MICONSTANTE en el espacio de nombres global, silenciosamente y sin error. Para situar la constante en un espacio de nombres, el espacio de nombres debe formar parte del nombre, escrito sin un separador de espacio de nombres inicial, como en define('Mi\Espacio\MICONSTANTE', 1) o define(__NAMESPACE__ . '\MICONSTANTE', 1). A diferencia de defined() y constant(), define() no elimina un separador inicial: define('\Mi\Espacio\MICONSTANTE', 1) devuelve true pero crea una constante que nunca puede ser recuperada. Como el nombre es una cadena simple, los alias introducidos por sentencias use no se aplican a él. En una cadena entre comillas dobles, los separadores de espacio de nombres deben escaparse, como en "Mi\\Espacio\\MICONSTANTE".

value

El valor de la constante.

Advertencia

Aunque es técnicamente posible definir constantes de tipo resource, esto se desaconseja y puede causar comportamientos inesperados.

case_insensitive

Si es true, el nombre de la constante será insensible a mayúsculas/minúsculas: CONSTANT y Constant representan valores idénticos.

Advertencia

Definir constantes insensibles a mayúsculas/minúsculas está deprecado a partir de PHP 7.3.0. A partir de PHP 8.0.0, solo false es un valor aceptable, pasar true producirá una advertencia.

Nota:

Las constantes insensibles a mayúsculas/minúsculas se almacenan en minúsculas.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Historial de cambios

Versión Descripción
8.1.0 value ahora puede ser un objeto.
8.0.0 Pasar true a case_insensitive ahora emite una E_WARNING. Pasar false sigue siendo permitido.
7.3.0 case_insensitive está deprecado y será eliminado en la versión 8.0.0.

Ejemplos

Ejemplo #1 Definición de una constante

<?php
define("CONSTANT", "Hola mundo.");
echo CONSTANT; // muestra "Hola mundo."
echo Constant; // muestra "Constant" y emite una advertencia

define("GREETING", "Hola tú.", true);
echo GREETING; // muestra "Hola tú."
echo Greeting; // muestra "Hola tú."

// Funciona desde PHP 7
define('ANIMALS', array(
    'perro',
    'gato',
    'aves'
));
echo ANIMALS[1]; // muestra "gato"

?>

Ejemplo #2 Constantes con Nombres Reservados

Este ejemplo ilustra la posibilidad de definir una constante con el mismo nombre que una constante mágica. Dado que el comportamiento resultante es confuso, esta práctica no se recomienda. 

<?php
var_dump(defined('__LINE__'));
var_dump(define('__LINE__', 'test'));
var_dump(constant('__LINE__'));
var_dump(__LINE__);
?>

El ejemplo anterior mostrará:

bool(false)
bool(true)
string(4) "test"
int(5)

Véase también