Пространства имён в PHP

Рассмотрим, что такое пространства имён в PHP.

В большом проекте трудно уследить за тем чтобы все имена переменных, классов и функций имели разные названия и не повторялись, не перезаписывая друг друга. Особенно часто можно встретить ситуация при использовании сторонних библиотек в своем проекте. При ее подключении может произойти сбой в программе, такак окажется что она в себе использует переменные с такими же именами, как и у вас в проекте. Например с распространёнными именами переменных, таких как model, db, result, data и так далее. Чтобы не сталкиваться с такой проблемой — можно использовать пространства имен — namespace.

Пространство имён (namespace) — это некоторое хранилище, созданное для абстрактной группировки уникальных идентификаторов(имён).

Т.е. если вы будете использовать пространства имён, то сможете смело подключать сторонние библиотеки и не бояться, что там будут такие же имена, как и в вашем коде. Перейдём к практике.

Примеры использования пространства имен в php

Создадим файл myclass.php с таким содержанием:

<?php
  namespace my\oneProject;
  class MyClass { }
?>

Здесь мы создали класс в пространстве имён my\oneProject. Обратите внимание, необходимо писать именно обратный слеш.

Теперь в файле index.php напишем следующее:

<?php
  require_once("myclass.php");
  $mc = new MyClass(); // Ошибка: класс не найден
  $mc = new my\oneProject\MyClass(); // всё работает
?>

Как видите, теперь создать класс просто так не получится, нужно обязательно указывать, в каком пространстве имён он лежит.

Мы можем указывать сразу несколько пространств имён в одном файле:

<?php
  namespace Project;

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

  namespace AnotherProject;

  const CONNECT_OK = 1;
  class Connection { }
  function connect() { }
?>

Не смотря на то, что у нас абсолютно идентичные названия классов, функций и констант, у нас не будет конфликта имён, т.к. они лежат в разных пространствах.

Мы можем также применять синтаксис со скобками.

<?php
namespace Project {
	const CONNECT_OK = 1;
	class Connection { }
	function connect() { }
}

namespace AnotherProject {
	const CONNECT_OK = 1;
	class Connection { }
	function connect() { }
}
?>

Если вы объединяете код в глобальном пространстве имён с кодом в других пространствах, то используется только синтаксис со скобками.

<?php
namespace Project {
	const CONNECT_OK = 1;
	class Connection { }
	function connect() { }
}

namespace {       // глобальный код
	session_start();
	$a = Project\connect();
	echo Project\Connection::start();
}
?>

Внимание! При определении пространства имен до него не должно ничего быть, никаких переменных, функций или классов. Пространство имен всегда идет первым уровнем, а затем все остальное. Определение пространства имён всегда должно идти первой строчкой кода. Если вы напишите так, то будет ошибка:

<?php
  $name = "John Doe";
  namespace MySpace;
...

Чтобы узнать, в каком пространстве имён вы сейчас находитесь, можно воспользоваться константой __NAMESPACE__

<?php
  namespace Project;
  echo '"', __NAMESPACE__, '"'; // выведет "Project"
?>

С помощью данной константы можно, например, динамически конструировать имена:

<?php
  namespace Project;

  function incl($classname) {
	$a = __NAMESPACE__ . '\\' . $classname;
	return new $a;
  }
?>

На этом все. Спасибо за внимание!)