Самое очевидное назначение пространств имён — решить проблему дублирования имён. PHP не позволяет двум функциям или классам иметь одинаковое имя; иначе возникнет фатальная ошибка. В таком случае проблему можно решить, просто избегая дублирования имён, и один из наиболее распространённых подходов — договориться о префиксе.
Пример: в проекте есть два модуля: article и message board, и в каждом есть класс Comment, который обрабатывает сообщения пользователей. Позже я, возможно, захочу добавить некоторую функциональность статистики для всех сообщений пользователей, например получение общего количества сообщений. На этом этапе хорошим подходом было бы вызывать методы, предоставляемые их классами Comment, но одновременно подключать оба класса Comment, очевидно, недопустимо — код выдаст ошибку. Переписывание любого Comment в другом месте также снизило бы поддерживаемость. В этом случае единственный вариант — переименовать классы. Я договорился о правиле именования: добавлять имя модуля перед именем класса, вот так: Article_Comment, MessageBoard_Comment.
Как видите, имена становятся очень длинными, а значит, при дальнейшем использовании Comment будет написано больше кода (как минимум больше символов). Более того, если в будущем в модули добавят больше интеграционных функций или модули начнут вызывать друг друга, имена придётся переименовывать всякий раз, когда возникнет дублирование. Конечно, если заметить эту проблему в начале проекта и задать правила именования, этого можно эффективно избежать. Другое решение — рассмотреть использование пространств имён.
Примечание:Константы, упомянутые в этой статье: начиная с PHP 5.3 ключевое слово const можно использовать вне классов. И const, и define используются для объявления констант (их различия здесь не рассматриваются), но в пространстве имён define имеет глобальную область видимости, тогда как const действует в текущем пространстве. Константы, о которых я говорю в этой статье, относятся к константам, объявленным с помощью const.
Основы
Пространства имён разделяют код на разные пространства (области). Имена констант, функций и классов (чтобы не напрягаться, ниже я буду называть их «элементами») в каждом пространстве не влияют друг на друга. Это несколько похоже на концепцию «инкапсуляции», о которой мы часто говорим.
Чтобы создать пространство имён, нужно использовать ключевое слово namespace, вот так:
<?php //创建一个名为'Article'的命名空间 namespace Article; ?>
Обратите внимание, что в текущем файле скрипта перед первым namespace не может быть никакого кода. Все следующие варианты использования неверны:
Пример 1
//在脚本前面写了一些逻辑代码
<?php
$path = "/";
class Comment { }
namespace Article;
?>
Пример 2
</html> <?php namespace Article; ?>
Почему я упомянул первое пространство имён? Потому что в одном файле скрипта можно создать несколько пространств имён.
Ниже я создал два пространства имён и, заодно, добавил в каждое пространство элемент класса Comment:
<?php
//创建一个名为'Article'的命名空间
namespace Article;
//此Comment属于Article空间的元素
class Comment { }
//创建一个名为'MessageBoard'的命名空间
namespace MessageBoard;
//此Comment属于MessageBoard空间的元素
class Comment { }
?>
Элементы в разных пространствах нельзя вызывать напрямую друг из друга; нужно использовать синтаксис пространств имён:
<?php
namespace Article;
class Comment { }
namespace MessageBoard;
class Comment { }
//调用当前空间(MessageBoard)的Comment类
$comment = new Comment();
//调用Article空间的Comment类
$article_comment = new \Article\Comment();
?>
Как видите, при вызове класса Comment в пространстве Article из пространства MessageBoard используется синтаксис, похожий на путь к файлу:\имя пространства имён\имя элемента
Помимо классов, для функций и констант использование такое же. Ниже я создал новые элементы для двух пространств и вывел их значения в пространстве MessageBoard.
<?php
namespace Article;
const PATH = '/article';
function getCommentTotal() {
return 100;
}
class Comment { }
namespace MessageBoard;
const PATH = '/message_board';
function getCommentTotal() {
return 300;
}
class Comment { }
//调用当前空间的常量、函数和类
echo PATH; ///message_board
echo getCommentTotal(); //300
$comment = new Comment();
//调用Article空间的常量、函数和类
echo \Article\PATH; ///article
echo \Article\getCommentTotal(); //100
$article_comment = new \Article\Comment();
?>
И действительно, я получил данные элемента из пространства Article.
Подпространства имен
Логично, что синтаксис вызова пространств имён похож на путь к файлу; он позволяет определять подпространства имён, чтобы описывать связи между различными пространствами.
Извините, я забыл упомянуть, что модули Article и MessageBoard на самом деле оба находятся в одном и том же проекте Blog. Если выразить их связь с помощью пространств имён, это выглядит так:
<?php
//我用这样的命名空间表示处于blog下的article模块
namespace Blog\Article;
class Comment { }
//我用这样的命名空间表示处于blog下的message board模块
namespace Blog\MessageBoard;
class Comment { }
//调用当前空间的类
$comment = new Comment();
//调用Blog\Article空间的类
$article_comment = new \Blog\Article\Comment();
?>
Более того, подпространства имён можно определять на множество уровней, например:Blog\Article\Archives\Date
Глобальное пространство
У меня есть файл скрипта common_inc.php с некоторыми полезными функциями и классами в нём:
<?php
function getIP() { }
class FilterXSS { }
?>
Если этот скрипт включён внутри пространства имён, элементы скрипта не будут принадлежать этому пространству имён. Если скрипт не определяет никаких других пространств имён, его элементы всегда останутся в глобальном пространстве:
<?php namespace Blog\Article; //引入脚本文件 include './common_inc.php'; $filter_XSS = new FilterXSS(); //出现致命错误:找不到Blog\Article\FilterXSS类 $filter_XSS = new \FilterXSS(); //正确 ?>
Чтобы вызвать элементы из глобального пространства, просто добавьте \ перед именем элемента; иначе парсер PHP подумает, что вы хотите вызвать элемент в текущем пространстве. Помимо пользовательских элементов, встроенные элементы PHP также принадлежат глобальному пространству.
Стоит упомянуть, что на самом деле функциям и константам в глобальном пространстве не нужно добавлять обратную косую черту\и их всё равно можно вызывать нормально (я не понимаю, почему PHP так делает), но чтобы правильно различать элементы, всё же рекомендуется добавлять её при вызове функций.\
Терминология имён
Прежде чем обсуждать псевдонимы и импорт, вам нужно знать терминологию трёх типов имён применительно к пространствам имён и то, как PHP их разрешает. Официальная документация объясняет это очень хорошо, поэтому я воспользуюсь ею напрямую.
- 1. Неквалифицированные имена, или имена классов без префикса, например $comment = new Comment();. Если текущее пространство имён — Blog\Article, Comment будет разрешено как Blog\Article\Comment. Если код, использующий Comment, не содержится ни в одном пространстве имён (в глобальном пространстве), то Comment будет разрешено как Comment.
- 2. Квалифицированные имена, или имена с префиксом, например $comment = new Article\Comment();. Если текущее пространство имён — Blog, то Comment будет разрешено как Blog\Article\Comment. Если код, использующий Comment, не содержится ни в одном пространстве имён (в глобальном пространстве), то Comment будет разрешено как Comment.
- 3. Полностью квалифицированные имена, или имена, включающие оператор глобального префикса, например $comment = new \Article\Comment();. В этом случае Comment всегда разрешается как буквальное имя в коде, Article\Comment.
Фактически, вы можете сравнить эти три типа имён с именем файла (например, comment.php), именем относительного пути (например, ./article/comment.php) и именем абсолютного пути (например, /blog/article/comment.php), что может облегчить их понимание.
Я использовал несколько примеров, чтобы проиллюстрировать их:
<?php
//创建空间Blog
namespace Blog;
class Comment { }
//非限定名称,表示当前Blog空间
//这个调用将被解析成 Blog\Comment();
$blog_comment = new Comment();
//限定名称,表示相对于Blog空间
//这个调用将被解析成 Blog\Article\Comment();
$article_comment = new Article\Comment(); //类前面没有反斜杆\
//完全限定名称,表示绝对于Blog空间
//这个调用将被解析成 Blog\Comment();
$article_comment = new \Blog\Comment(); //类前面有反斜杆\
//完全限定名称,表示绝对于Blog空间
//这个调用将被解析成 Blog\Article\Comment();
$article_comment = new \Blog\Article\Comment(); //类前面有反斜杆\
//创建Blog的子空间Article
namespace Blog\Article;
class Comment { }
?>
На самом деле, я всё это время использовал неквалифицированные имена и полностью определённые имена; теперь их наконец можно называть своими именами.
Псевдонимы и импорт
Псевдонимы и импорт можно рассматривать как сокращение для вызова элементов пространства имён. PHP не поддерживает импорт функций или констант.
Оба реализуются через оператор use:
<?php
namespace Blog\Article;
class Comment { }
//创建一个BBS空间(我有打算开个论坛)
namespace BBS;
//导入一个命名空间
use Blog\Article;
//导入命名空间后可使用限定名称调用元素
$article_comment = new Article\Comment();
//为命名空间使用别名
use Blog\Article as Arte;
//使用别名代替空间名
$article_comment = new Arte\Comment();
//导入一个类
use Blog\Article\Comment;
//导入类后可使用非限定名称调用元素
$article_comment = new Comment();
//为类使用别名
use Blog\Article\Comment as Comt;
//使用别名代替空间名
$article_comment = new Comt();
?>
Я заметил — что произойдёт, если при импорте элемента в текущем пространстве имён уже есть элемент с таким же именем? Очевидно, результатом будет фатальная ошибка.
<?php
namespace Blog\Article;
class Comment { }
namespace BBS;
class Comment { }
Class Comt { }
//导入一个类
use Blog\Article\Comment;
$article_comment = new Comment(); //与当前空间的Comment发生冲突,程序产生致命错误
//为类使用别名
use Blog\Article\Comment as Comt;
$article_comment = new Comt(); //与当前空间的Comt发生冲突,程序产生致命错误
?>
Динамический вызов
PHP предоставляет ключевое слово namespace и магическую константу __NAMESPACE__ для динамического доступа к элементам. __NAMESPACE__ можно использовать для динамического доступа, объединяя строки:
<?php
namespace Blog\Article;
const PATH = '/Blog/article';
class Comment { }
//namespace关键字表示当前空间
echo namespace\PATH; ///Blog/article
$comment = new namespace\Comment();
//魔法常量__NAMESPACE__的值是当前空间名称
echo __NAMESPACE__; //Blog\Article
//可以组合成字符串并调用
$comment_class_name = __NAMESPACE__ . '\Comment';
$comment = new $comment_class_name();
?>
Проблемы со строковой формой вызова
В примере динамического вызова выше мы увидели подход к динамическому вызову в строковой форме. Если вы хотите использовать этот подход, нужно учесть два момента.
1. При использовании двойных кавычек специальные символы могут экранироваться.
<?php
namespace Blog\Article;
class name { }
//我是想调用Blog\Article\name
$class_name = __NAMESPACE__ . "\name"; //但是\n将被转义为换行符
$name = new $class_name(); //发生致命错误
?>
2. Это не будет считаться квалифицированным именем.
PHP определяет пространство, в котором находится элемент, а также ситуацию с импортом при компиляции скрипта. Однако при разборе скрипта вызовы в строковой форме могут считаться только неквалифицированными именами или полностью квалифицированными именами и никогда не могут быть квалифицированными именами.
<?php
namespace Blog;
//导入Common类
use Blog\Article\Common;
//我想使用非限定名称调用Blog\Article\Common
$common_class_name = 'Common';
//实际会被当作非限定名称,也就表示当前空间的Common类,但我当前类没有创建Common类
$common = new $common_class_name(); //发生致命错误:Common类不存在
//我想使用限定名称调用Blog\Article\Common
$common_class_name = 'Article\Common';
//实际会被当作完全限定名称,也就表示Article空间下的Common类,但我下面只定义了Blog\Article空间而不是Article空间
$common = new $common_class_name(); //发生致命错误:Article\Common类不存在
namespace Blog\Article;
class Common { }
?>
Итог
Я только начал изучать пространства имён PHP, поэтому не могу с ходу давать непроверенные советы. Лично я считаю, что пространства имён очень мощны как по роли, так и по функциональности; при написании плагинов или библиотек общего назначения больше не нужно беспокоиться о дублировании имён. Однако если проект уже достиг определённого этапа и нужно решить проблемы дублирования имён путём добавления пространств имён, думаю, объём работы будет не меньше, чем при рефакторинге имён. Также должен признать, что его синтаксис добавляет определённую сложность проекту, поэтому всё следует хорошо планировать с самого начала и установить соглашение об именовании.
Исходный URL: https://www.cnblogs.com/kuyuecs/p/3556421.html