PHP.mk документација

Просторни имиња

Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.

language.namespaces.definition.php PHP.net прокси Преводот се освежува
Оригинал на PHP.net
Патека language.namespaces.definition.php Локална патека за оваа страница.
Извор php.net/manual/en Оригиналниот HTML се реупотребува и локално се стилизира.
Режим Прокси + превод во позадина Кодовите, табелите и белешките остануваат читливи во истиот тек.
Просторни имиња

Референца за `language.namespaces.definition.php` со подобрена типографија и навигација.

language.namespaces.definition.php

Дефинирање на именски простори

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

Иако кој било валиден PHP код може да биде содржан во именски простор, само следниве типови на код се засегнати од именските простори: класи (вклучувајќи апстрактни класи, трајти и енами), интерфејси, функции и константи.

Именските простори се декларираат со користење на namespace клучниот збор. Датотека што содржи именски простор мора да го декларира именскиот простор на врвот на датотеката пред кој било друг код - со еден исклучок: declare keyword.

Пример #1 Декларирање на еден именски простор

<?php
namespace MyProject;

const
CONNECT_OK = 1;
class
Connection { /* ... */ }
function
connect() { /* ... */ }

?>

Забелешка: Целосно квалификуваните имиња (т.е. имиња што започнуваат со обратна коса црта) не се дозволени во декларациите на именски простор, бидејќи таквите конструкции се толкуваат како релативни изрази на именски простор.

Единствената програмска конструкција дозволена пред декларација на именски простор е declare изјава, за дефинирање на кодирањето на изворната датотека. Покрај тоа, ниту еден не-PHP код не смее да претходи на декларацијата на именски простор, вклучувајќи дополнителен празен простор:

Пример #2 Декларирање на еден именски простор

<html>
<?php
namespace MyProject; // fatal error - namespace must be the first statement in the script
?>

Покрај тоа, за разлика од која било друга PHP конструкција, истиот именски простор може да биде дефиниран во повеќе датотеки, дозволувајќи поделба на содржината на именскиот простор низ датотечниот систем.

Белешки од корисници 10 белешки

kuzawinski dot marcin na NOSPAM dot gmail dot com
пред 11 години
If your code looks like this:

<?php
    namespace NS;
?>

...and you still get "Namespace declaration statement has to be the very first statement in the script" Fatal error, then you probably use UTF-8 encoding (which is good) with Byte Order Mark, aka BOM (which is bad). Try to convert your files to "UTF-8 without BOM", and it should be ok.
danbettles на yahoo точка co точка uk
пред 16 години
Regarding constants defined with define() inside namespaces...

define() will define constants exactly as specified.  So, if you want to define a constant in a namespace, you will need to specify the namespace in your call to define(), even if you're calling define() from within a namespace.  The following examples will make it clear.

The following code will define the constant "MESSAGE" in the global namespace (i.e. "\MESSAGE").

<?php
namespace test;
define('MESSAGE', 'Hello world!');
?>

The following code will define two constants in the "test" namespace.

<?php
namespace test;
define('test\HELLO', 'Hello world!');
define(__NAMESPACE__ . '\GOODBYE', 'Goodbye cruel world!');
?>
FatBat
12 години пред
Expanding on @danbettles note, it is better to always be explicit about which constant to use.

<?php
    namespace NS;

    define(__NAMESPACE__ .'\foo','111');
    define('foo','222');

    echo foo;  // 111.
    echo \foo;  // 222.
    echo \NS\foo  // 111.
    echo NS\foo  // fatal error. assumes \NS\NS\foo.
?>
huskyr na gmail dot com
пред 16 години
"A file containing a namespace must declare the namespace at the top of the file before any other code"

It might be obvious, but this means that you *can* include comments and white spaces before the namespace keyword.

<?php
// Lots 
// of
// interesting
// comments and white space

namespace Foo;
class Bar {
}
?>
jeremeamia na gmail dot com
пред 16 години
You should not try to create namespaces that use PHP keywords. These will cause parse errors. 

Examples:

<?php
namespace Project/Classes/Function; // Causes parse errors
namespace Project/Abstract/Factory; // Causes parse errors
?>
пред 24 години
пред 5 години
namespace statement  is defined at first of the php files. But 
    before namespace declaration only three elements allowed.
      1.declare statement
      2.spaces
      3.comments
Анонимен
пред 17 години
@ RS: Also, you can specify how your __autoload() function looks for the files. That way another users namespace classes cannot overwrite yours unless they replace your file specifically.
Баптист
пред 17 години
There is nothing wrong with PHP namespaces, except that those 2 instructions give a false impression of package management.
... while they just correspond to the "with()" instruction of Javascript.

By contrast, a package is a namespace for its members, but it offers more (like deployment facilities), and a compiler knows exactly what classes are in a package, and where to find them.
пред 24 години
пред 5 години
Namespace name are case-insensitive.
namespace App
and
namespace app
are same meaning.

Besides, Namespace keword are case-insensitive.
Namespace App
namespace App
and
NAMESPACE App
are same meaning.
dino na tuxweb dot it
3 години пред
Please note that a PHP Namespace declaration cannot start with a number.
It took some time for me to debug...
На оваа страница

Автоматски outline од активната документација.

Насловите ќе се појават тука по вчитување.

Попрегледно читање

Примерите, changelog табелите и user notes се визуелно издвоени за да не се губат во долгата содржина.

Брз совет Користи го outline-от Скокни директно на главните секции од активната страница.
Извор Оригиналниот линк останува достапен Кога ти треба целосен upstream context, отвори го PHP.net во нов tab.