P+F: cosas que es necesario saber sobre los espacios de nombres
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
Esta sección está dividida en dos subsecciones: preguntas comunes, y algunas especificaciones de
implementación que son útiles para comprender completamente los espacios de nombres.
Primero, las preguntas comunes.
-
Si no utilizo espacios de nombres, ¿debería
preocuparme por algo de esto?
-
¿Cómo uso clases internas o
globales en un espacio de nombres?
-
¿Cómo uso clases, funciones
o constantes de espacios de nombres en su propio espacio de nombres?
-
¿Cómo se resuelve un nombre como
\mi\nombre
o
\nombre
?
-
¿Cómo se resuelve un nombre como
mi\nombre
?
-
¿Cómo se resuelve un nombre de clase no
cualificado como
nombre
?
-
¿Cómo se resuelve un
nombre de función o de constante no cualifcado
como
nombre
?
Existen unos pocos detalles de las implementaciones de espacios de nombres
que son útiles para enterderlos.
-
Importar nombres no entra en conflicto con
las clases definidas en el mismo fichero.
-
Los espacios de nombres anidados no están
permitidos.
-
Antes de PHP 5.6, ni las funciones ni
las constantes se pueden importar mediante la sentencia
use
.
-
Los nombres de espacios de nombres dinámicos
(identificadores entre comillas) deberían escaparse con una barra invertida.
-
Las constantes no definidas aludidas
usando cualquier barra invertida terminan en un error fatal
-
No se pueden sobrescribir las
constantes especiales NULL, TRUE, FALSE, ZEND_THREAD_SAFE o ZEND_DEBUG_BUILD
Si no utilizo espacios de nombres, ¿debería preocuparme por algo de esto?
No. Los espacios de nombres no afectan a ningún código existente de ninguna manera, o a ningún
código todavía por escribir que no contenga espacios de nombres. Se puede
escribir este código si se desea:
Ejemplo #1 Acceder a clases globales fuera de un espacio de nombres
<?php
$a = new \stdClass;
?>
Esto es funcionalmente equivalente a:
Ejemplo #2 Acceder a clases globales fuera de un espacio de nombres
<?php
$a = new stdClass;
?>
¿Cómo uso clases internas o globales en un espacio de nombres?
Ejemplo #3 Acceder a clases internas en espacios de nombres
<?php
namespace foo;
$a = new \stdClass;
function probar(\ArrayObject $ejemploalusiónatipo = null) {}
$a = \DirectoryIterator::CURRENT_AS_FILEINFO;
// extender una clase interna o global
class MiExcepción extends \Exception {}
?>
¿Cómo uso clases, funciones o constantes de espacios de nombres en su propio
espacio de nombres?
Ejemplo #4 Acceder a clases, funciones o constantes internas en un espacio de nombres
<?php
namespace foo;
class MiClase {}
// usar una clase desde el espacio de nombres actual como una declaración de tipo
function probar(MiClase $ejemploalusiónatipo = null) {}
// otra manera de usar una clase desde el espacio de nombres actual una declaración de tipo
function probar(\foo\MiClase $ejemploalusiónatipo = null) {}
// extender una clase desde el espacio de nombres actual
class Extendida extends MiClase {}
// acceder a una función global
$a = \funcglobal();
// acceder a una constante global
$b = \INI_ALL;
?>
¿Cómo se resuelve un nombre como \mi\nombre
o
\nombre
?
Los nombres que comienzan con una \
siempre se resuelven a aquello a lo que
se asemejan, así \mi\nombre
de hecho es mi\nombre
,
y \Exception
es Exception
.
Ejemplo #5 Nombres completamente cualificados
<?php
namespace foo;
$a = new \mi\nombre(); // instancia a la clase "mi\nombre"
echo \strlen('hola'); // llama a la función "strlen"
$a = \INI_ALL; // $a está establecida al valor de la constante "INI_ALL"
?>
¿Cómo se resuelve un nombre como mi\nombre
?
Los nombres que contienen una barra invertida pero no comienzan con una barra invertida como
mi\nombre
pueden resolverse de dos formas diferentes.
Si hay
una sentencia de importación que apode a otro nombre como mi
,
el alias de importación se aplica a mi
en mi\nombre
.
De lo contrario, al nombre del espacio de nombres actual se le antepone mi\nombre
.
Ejemplo #6 Nombres cualificados
<?php
namespace foo;
use blah\blah as foo;
$a = new mi\nombre(); // instancia a la clase "foo\mi\nombre"
foo\bar::nombre(); // llama a método estático "nombre" de la clase "blah\blah\bar"
mi\bar(); // llama a la función "foo\mi\bar"
$a = mi\BAR; // establece $a al valor de la constante "foo\mi\BAR"
?>
¿Cómo se resuelve un nombre de clase no cualificado como nombre
?
Los nombres de clases que no contienen una barra invertida como
nombre
se pueden resolver de dos formas diferentes.
Si hay
una sentencia de importación que apode a otro nombre como nombre
,
se aplica el alias de importación.
De lo contrario, al nombre del espacio de nombres actual se le antepone nombre
.
Ejemplo #7 Nombres de clases no cualificados
<?php
namespace foo;
use blah\blah as foo;
$a = new nombre(); // instancia a la clase "foo\nombre"
foo::nombre(); // llama al método estático "nombre" de la clase "blah\blah"
?>
¿Cómo se resuelve un nombre de función o de constante no cualifcado
como nombre
?
Los nombres de funciones o de constantes que no contienen una barra invertida como
nombre
se pueden resolver de dos formas diferentes.
Primero, al nombre del espacio de nombres actual se le antepone nombre
.
Finalmente, si el nombre
de la constante o de la función no existe
en el espacio de nombres actual, se emplea un nombre
de constante o función global,
si es que existe.
Ejemplo #8 Nombres de funciones o constantes no cualificados
<?php
namespace foo;
use blah\blah as foo;
const FOO = 1;
function mi() {}
function foo() {}
function sort(&$a)
{
\sort($a); // invoca a la función global "sort"
$a = array_flip($a);
return $a;
}
mi(); // calls "foo\mi"
$a = strlen('hola'); // llama a la función global "strlen" ya que "foo\strlen" no existe
$array = array(1,3,2);
$b = sort($array); // llama a la función "foo\sort"
$c = foo(); // llama a la función "foo\foo" - la importación no se aplica
$a = FOO; // establece $a al valor de la constante "foo\FOO"; la importación no se aplica
$b = INI_ALL; // establece $b al valor de la constante "INI_ALL"
?>
Importar nombres no entra en conflicto con las clases definidas en el mismo fichero.
Están permitidas las siguientes combinaciones de scripts:
No existe conflicto entre nombres, aunque la clase MiClase
exista
dentro del espacio de nombres mis\cosas
, porque la definición de MiClase está
en otro fichero. Sin embargo, el siguiente ejemplo causa un error fatal por el conflicto entre nombres,
debido a que MiClase está definida en el mismo fichero que el de la sentencia use.
Los espacios de nombres anidados no están permitidos.
PHP no permite los espacios de nombres anidados
Sin embargo, es fácil simular los espacios de nombres anidados de la siguiente manera:
Antes de PHP 5.6, ni las funciones ni las constantes se pueden importar mediante la sentencia
use
.
Ants de PHP 5.6, los únicos elementos que se ven afectados por la sentencia use
son los
espacios de nombres y los nombres de clases. Para abreviar una constante o una función larga,
se ha de importar el espacio de nombres que la contiene:
A partir de PHP 5.6, está permitido apodar o imortar nombres de funciones y de constantes.
Los nombres de espacios de nombres dinámicos (identificadores entre comillas) deberían escaparse con una barra invertida.
Es muy importante darse cuenta de que, debeido a que la barra invertida se usa como carácter de escape
dentro de cadenas, se deberían emplear dos barras inverticas cuando se utilicen dentro de cadenas. De lo contrario,
existe el riesgo de obtener consecuencias inesperadas:
Ejemplo #9 Peligros de usar nombres de espacios de nombres dentro de una cadena entre comillas dobles
<?php
$a = "peligroso\nombre"; // ¡\n es una nueva línea dentro de las cadenas entre comillas dobles!
$obj = new $a;
$a = 'sin\peligro\alguno'; // aquí sin problemas.
$obj = new $a;
?>
Dentro de una cadena entre comillas dobles, es más seguro usar la secuencia de escape de la barra
invertida, pero aún se recomienda como práctica escapar las barras invertidas en todas las cadenas.
Las constantes no definidas a las que se hace referencia usando una barra invertida terminan con un error fatal
Cualquier constante no definida que no sea cualificada, como FOO
,
generará una aviso explicando que PHP asume que FOO
es el valor
de la constante. Cualquier constante, cualificada o completamente cualificada, que contenga una
barra invertida producirá un error fatal si no se encuentra.
Ejemplo #10 Constantes no definidas
<?php
namespace bar;
$a = FOO; // produce un aviso - constante no definida "FOO" se asume que es "FOO";
$a = \FOO; // error fatal, constante FOO del espacio de nombres no definida
$a = Bar\FOO; // error fatal, constante bar\Bar\FOO del espacio de nombres no definida
$a = \Bar\FOO; // error fatal, constante Bar\FOO del espacio de nombres no definida
?>
No se pueden sobrescribir las constantes especiales NULL, TRUE, FALSE, ZEND_THREAD_SAFE o ZEND_DEBUG_BUILD
Cualquier intento de definir una constante de espacio de nombres que sea una constante
especial interna, resultará en un error fatal:
Ejemplo #11 Constantes no definidas
<?php
namespace bar;
const NULL = 0; // error fatal;
const true = 'estúpido'; // también error fatal;
// etc.
?>