szit

Ez az oldal csak olvasható. Megtekintheted a forrását, de nem változtathatod meg. Ha úgy gondolod, hogy ez helytelen, kérdezd az Adminisztrátorokat!
[[oktatas:programozás:php:php_oop|< PHP OOP]]

====== Névterek ======

  * **Szerző:** Sallai András
  * Copyright (c) Sallai András, 2021
  * Licenc: [[https://creativecommons.org/licenses/by-sa/4.0/|CC Attribution-Share Alike 4.0 International]]
  * Web: https://szit.hu

===== A névterekről =====


A névtereknek két előnyük van:
  * Csoportosítjuk az összetartozó osztályokat.
  * Egy nevet többször is felhasználhatunk.


A névterek az 5.3 PHP verziótól állnak rendelkezésre. 

{{:oktatas:programozas:php:php_oop:globalis_ter.png?400|}}
===== Létrehozás =====

<code php>
namespace Nevter1;
</code>


A névtér meghatározásoknak mindig a többi PHP utasítás előtt kell állnia.

<code php>
<?php

namespace Nevter1;
echo "Helló";
</code>


===== Dolgozók =====

==== Ütközés ====

Hibát kapunk a következő végrehajtásakor.

<code php index.php>
<?php

include "hatvan.php";
include "miskolc.php";


$a = new Hatvan\Dolgozo;
$b = new Miskolc\Dolgozo;
</code>

<code php hatvan.php>
<?php

class Dolgozo {
    function __construct() {
         echo "Hatvani dolgozó<br>";
    }
}

</code>

<code php miskolc.php>
<?php


class Dolgozo {
    function __construct() {
         echo "Miskolci dolgozó<br>";
    }
}

</code>


Ha futtatjuk a kódot, **hibát kapunk**, mivel ütközik a hatvan.php Dolgozo osztálya a miskolc.php
dolgozó osztályával.

==== Minősített név ====

Tegyük a hatvan.php fájlban a dolgozó osztályt a Hatvan névtérbe:

<code php index.php>
<?php

include "hatvan.php";
include "miskolc.php";


$a = new Hatvan\Dolgozo;
</code>

<code php hatvan.php>
<?php

namespace Hatvan;

class Dolgozo {
    function __construct() {
         echo "Hatvani dolgozó<br>";
    }
}

</code>

<code php miskolc.php>
<?php

class Dolgozo {
    function __construct() {
         echo "Miskolci dolgozó<br>";
    }
}

</code>


Az index.php-ban a Hatvan\Dolgozo az osztály minősített (angolul: qualified) neve.
A hatvan.php-ban található Dolgozo osztályt leválasztottuk a globális névtérből
a Hatvan névtérbe, így ütközés már nem áll fenn. 



==== Nem minősített név ====

Tegyük a index.php tartalmát is a Hatvan névtérbe. Így nem kell megadni a Dolgozo osztály
példányosításánál a névteret, nem minősített névvel (angolul: unqualified name) hivatkozhatunk rá:

<code php index.php>
<?php

namespace Hatvan;

include "hatvan.php";
include "miskolc.php";


$a = new Dolgozo; // nem minősített név
</code>

<code php hatvan.php>
<?php

namespace Hatvan;

class Dolgozo {
    function __construct() {
         echo "Hatvani dolgozó<br>";
    }
}

</code>

<code php miskolc.php>
<?php

class Dolgozo {
    function __construct() {
         echo "Miskolci dolgozó<br>";
    }
}

</code>

==== Teljesen minősített név ====

De meghívhatom a globális térben maradt Dolgozo osztályt is, ha "\" karakterrel
a globális térre, vagy a gyökérre hivatkozom. Ezt nevezik teljesen minősített névnek
(angolul: fully qualified name, FQDN).

<code php index.php>
<?php

namespace Hatvan;

include "hatvan.php";
include "miskolc.php";


$a = new Dolgozo; // nem minősített név
$b = new \Dolgozo; // teljesen minősített név
</code>

<code php hatvan.php>
<?php

namespace Hatvan;

class Dolgozo {
    function __construct() {
         echo "Hatvani dolgozó<br>";
    }
}

</code>

<code php miskolc.php>
<?php

class Dolgozo {
    function __construct() {
         echo "Miskolci dolgozó<br>";
    }
}

</code>


==== A use használata ====

Ha nem minősített nevet használunk, és az index.php tartalmát nem szeretnénk
a Hatvan névtérbe helyezni, használjuk a use kulcsszót. Ezzel használatba
vehetjük az adott névtér, adott osztályát:


<code php index.php>
<?php

include "hatvan.php";
include "miskolc.php";

use Hatvan\Dolgozo

$a = new Dolgozo; // nem minősített név
</code>

<code php hatvan.php>
<?php

namespace Hatvan;

class Dolgozo {
    function __construct() {
         echo "Hatvani dolgozó<br>";
    }
}

</code>

<code php miskolc.php>
<?php

class Dolgozo {
    function __construct() {
         echo "Miskolci dolgozó<br>";
    }
}

</code>

Így viszont a nem minősített név nem használható.
==== Az álnév használata ====

Az álnév segítségével használható a nem minősített név is:
<code php>
<?php

include "hatvan.php";
include "miskolc.php";

use Hatvan\Dolgozo as HatvaniDolgozo;

$a = new HatvaniDolgozo;
$b = new Dolgozo;
</code>

===== Forrás =====

  * https://www.youtube.com/watch?v=zTxz_kOLIZM (2021)
  * https://symfonycasts.com/screencast/php-namespaces/namespaces (2021)
  * https://www.youtube.com/watch?v=0SZW-wBY_WI (2021)