Vlourido: /* Operador use */

2013-08-01T11:13:45Z

Operador use

Página nueva

== Espazos de nomes ==

A partires da versión 5.3 de PHP, introduciuse na linguaxe a capacidade de empregar espazos de nomes. É unha característica similar a que podemos atopar noutras linguaxes como Java ou C#. Os espazos de nomes permiten agrupar baixo un nome un conxunto de elementos (clases, interfaces, funcións e constantes mediante '''const''', non define), de xeito que non se produzan conflictos entre os seus nomes e outros nomes iguais presentes noutros espazos de nomes.

=== Declaración dos espazos de nomes ===

Os espazos de nomes [http://www.php.net/manual/es/language.namespaces.definition.php decláranse empregando a palabra '''namespace''']. Faise antes de calquera outro código (excepto sentenzas [http://www.php.net/manual/es/control-structures.declare.php declare]), e existen dúas sintaxes posibles:

* Rematando a sentenza nun punto e coma (''';''').

<div style="margin-left: 2em;">
<source lang="php">
namespace Platega;

class xxx {
...
}
...

</source>
</div>

* Pechando entre chaves o código pertencente ao espazo de nomes.

<div style="margin-left: 2em;">
<source lang="php">
namespace Platega {
class xxx {
...
}
...
}
</source>
</div>

Recoméndase empregar a primeira forma. A segunda é máis lexible cando temos dous ou máis espazos de nomes nun mesmo ficheiro, aínda que é aconsellable ter un único espazo de nomes por ficheiro.

Tamén é posible ter un mesmo espazo de nomes espallado en varios ficheiros. Deste xeito poderiamos, por exemplo, definir cada clase dun espazo de nomes no seu propio ficheiro.

No caso das librarías complexas de código, aconséllase empregar xerarquías de espazos de nomes. Faise separando cada rama do espazo de nomes da seguinte por unha barra invertida ('''\''').

<div style="margin-left: 2em;">
<source lang="php">
namespace Platega\Informatica\PHP;

class xxx {
...
}
...

</source>
</div>

=== Utilización dos espazos de nomes ===

Todos os obxecto que se atopan fora dun espazo de nomes definido mediante un namespace, forman parte do espazo de nomes global. Dependendo do espazo de nomes ao que pertenza o código que estea a executarse, poderemos empergar unha ou outra sintaxe para acceder a elementos no mesmo ou noutro espazo de nomes. Por exemplo, no seguinte código:

<source lang="php">
namespace Platega {
const OLA = "Ola Platega.";
...
}
namespace Platega\PHP {
const OLA = "Ola Platega PHP.";
...
}
</source>

* Se o código que estamos a executar se atopa '''no espazo de nomes global''', teremos que empregar [http://www.php.net/manual/es/language.namespaces.rules.php nomes completamente cualificados] (rutas absolutas) para acceder ás constantes "OLA":

<div style="margin-left: 2em;">
<source lang="php">
// Amosa "Ola Platega."
echo \Platega\OLA;

// Amosa "Ola Platega PHP."
echo \Platega\PHP\OLA;
</source>
</div>

:Como o espazo de nomes global atópase na raíz ('''\'''), tamén podemos emprear [http://www.php.net/manual/es/language.namespaces.rules.php nomes parcialmente cualificados] (rutas relativas) para acceder ás contantes anteriores:

<div style="margin-left: 2em;">
<source lang="php">
// Amosa "Ola Platega."
echo Platega\OLA;

// Amosa "Ola Platega PHP."
echo Platega\PHP\OLA;
</source>
</div>

* Se o código que estamos a executar se atopa '''no espazo de nomes PLATEGA''', podemos emprear nomes non cualificados, totalmente cualificados ou parcialmente cualificados do seguinte xeito:

<div style="margin-left: 2em;">
<source lang="php">
// Nome totalmente cualificado. Amosa "Ola Platega."
echo \Platega\OLA;
// Nome non cualificado. Tamén amosa "Ola Platega."
echo OLA;

// Nome totalmente cualificado. Amosa "Ola Platega PHP."
echo \Platega\PHP\OLA;
// Nome parcialmente cualificado. Amosa "Ola Platega PHP."
echo PHP\OLA;
</source>
</div>

:Neste caso, cando empregamos nomes non cualificados PHP busca os elementos primeiro no espazo de nomes actual e despois no global. Para acceder a elementos do espazo de nomes global nos que ocurra unha colisión de nomes, teremos que empregar unha barra invertida.

<div style="margin-left: 2em;">
<source lang="php">
// Nome non cualificado. Accede á constante do espazo de nomes global PHP_VERSION
echo PHP_VERSION;
// Se no espazo de nomes actual houbera outra constante con ese mesmo nome
// teriamos que empregar un nome completamente cualificado para acceder á do espazo de nomes global
echo \PHP_VERSION;
</source>
</div>

=== Operador use ===

Podemos empregar o operador '''[http://www.php.net/manual/es/language.namespaces.importing.php use]''', o mesmo que se usa nos [[Curso_POO_PHP_Rasgos|trazos]], para simplificar as referencias aos elementos dun espazo de nomes. Por exemplo, partindo dos seguintes espazos de nomes:

<source lang="php">
<?php
namespace Platega {
const OLA = "Ola Platega.";
class Proba {
function __construct() {echo "Proba en Platega." . "<br />";}
}
}
namespace Platega\PHP {
const OLA = "Ola Platega PHP.";
class Proba {
function __construct() {echo "Proba en Platega PHP." . "<br />";}
}
}
?>
</source>

Se queremos empregar elementos pertencentes ao espazo de nomes "Platega\PHP", o normal é facer:

<source lang="php">
<?php
$proba_platega_php = new \Platega\PHP\Proba();
?>
</source>

Cando traballamos con moitos elementos dun mesmo espazo de nomes, podemos porles un alias para acortar as rutas. Esta é a utilidade de '''use''':

<source lang="php">
<?php
use Platega\PHP as P;
$proba_platega_php = new P\Proba();
?>
</source>

Se omitimos a segunda parte do ''use'' (o ''as''), o alias a empregar é o último nome na xerarquía.

<source lang="php">
<?php
use Platega\PHP ;
$proba_platega_php = new PHP\Proba();
?>
</source>

O operador ''use'' tamén admite alias para os nomes das clases.

<source lang="php">
<?php
use Platega\PHP\Proba ;
$proba_platega_php = new Proba();
?>
</source>

Pero se dende dentro do espazo de nomes "Platega" facemos:

<source lang="php">
<?php
namespace Platega;
use Platega\PHP\Proba;
$proba = new Proba();
</source>

O nome da clase "Proba" pode facer referencia á do espazo de nomes actual (\Platega) ou á clase "Proba" da que fixemos o alias, a do espazo de nomes "\Platega\PHP". Cando isto sucede, PHP prioriza os alias sobre os elementos da clase actual. Isto é, o código anterior amosa a cadea "Proba en Platega PHP.".

Nestes casos podemos empregar a palabra clave '''[http://www.php.net/manual/es/language.namespaces.nsconstants.php namespace]''' para facer referencia aos elementos do espazo de nomes actual.

<source lang="php">
<?php
namespace Platega;
use Platega\PHP\Proba;
$proba1 = new Proba(); // Amosa "Proba en Platega PHP."
$proba2 = new namespace\Proba(); // Amosa "Proba en Platega."
</source>

--[[Usuario:Vlourido|Víctor Lourido]] 12:33 23 jul 2013 (CEST)

Curso POO PHP Espazos de nomes - Historial de revisiones

Vlourido: /* Operador use */