Описание нескольких пространств имён в одном файле

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

В одном файле разрешается объявлять больше одного пространства имён. Многократные пространства имён в одном файле разрешается определять двумя синтаксисами:

Пример #1 Объявление набора пространств имён синтаксисом простой комбинации

<?php

namespace MyProject;

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

namespace
AnotherProject;

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

Этот синтаксис не рекомендуют для комбинирования пространств имён в одном файле. Вместо него лучше пользоваться альтернативным синтаксисом со скобками.

Пример #2 Объявление набора пространств имён синтаксисом со скобками

<?php

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

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

Практика написания кода настоятельно не рекомендует объединять пространства имён в одном файле. Главный сценарий того, когда это потребуется, — объединение нескольких PHP-файлов в один файл.

Для объединения кода в глобальном пространстве имён с кодом в других пространствах имён пользуются только синтаксисом со скобками. Глобальный код должен быть помещён в конструкцию описания пространства имён без указания имени:

Пример #3 Описание глобального и обычного пространства имён в одном файле

<?php
namespace MyProject {

const
CONNECT_OK = 1;
class
Connection {
public static function
start() {
print
__METHOD__ . "\n";
}
}

function
connect() {
print
__FUNCTION__ . "\n";
}
}

namespace {
// Глобальный код
print strlen("hi") . "\n";
MyProject\connect();
MyProject\Connection::start();
}

Никакой PHP-код нельзя размещать за пределами скобок пространства имён, кроме начального выражения declare.

Пример #4 Описание глобального и обычного пространства имён в одном файле

<?php
declare(strict_types=1);
namespace
MyProject {

const
CONNECT_OK = 1;
class
Connection {
public static function
start() {
print
__METHOD__ . "\n";
}
}

function
connect() {
print
__FUNCTION__ . "\n";
}
}

namespace {
// Глобальный код
print strlen("hi") . "\n";
MyProject\connect();
MyProject\Connection::start();
}