Utilisation détaillée de l'espace de noms PHP-tutoriel php-php.cn

L'un des objectifs les plus clairs des espaces de noms est de résoudre le problème des noms en double. PHP ne permet pas à deux fonctions ou classes d'avoir le même nom, sinon une erreur fatale se produira. Dans ce cas, le problème peut être résolu à condition d'éviter la duplication de nom. La méthode la plus courante consiste à se mettre d'accord sur un préfixe.

Exemple : Il y a deux modules dans le projet : article et forum de messages, chacun ayant une classe Comment qui gère les commentaires des utilisateurs. Plus tard, je souhaiterai peut-être ajouter des fonctions de statistiques d'informations pour tous les messages utilisateur. Par exemple, je souhaite obtenir le nombre de tous les messages. Pour le moment, c'est une bonne idée d'appeler les méthodes fournies par leurs commentaires, mais il n'est évidemment pas possible d'introduire leurs classes de commentaires respectives en même temps. Le code fera des erreurs, et la réécriture de n'importe quel commentaire à un autre endroit le fera également. réduire la maintenabilité. Pour le moment, je ne peux que reconstruire le nom de la classe. J'ai convenu d'une règle de dénomination, en ajoutant le nom du module devant le nom de la classe, comme ceci : Article_Comment, MessageBoard_Comment

Comme vous pouvez le voir, le nom devient très long, ce qui signifie que lorsque j'utiliserai Comment à l'avenir, j'écrirai plus de code (au moins plus de caractères). De plus, si vous souhaitez ajouter plus de fonctions d'intégration à chaque module à l'avenir, ou vous appeler mutuellement, vous devrez reconstruire les noms lorsque des noms en double apparaissent. Bien entendu, ce problème peut être évité en remarquant ce problème au début du projet et en spécifiant des règles de dénomination. Une autre solution pourrait consister à utiliser des espaces de noms.

Remarque :

Constantes mentionnées dans cet article : à partir de PHP5.3, le mot-clé const peut être utilisé en dehors de la classe. Const et Defin sont utilisés pour déclarer des constantes (leurs différences ne sont pas détaillées), mais dans un espace de noms, Defin agit globalement, tandis que const agit sur l'espace actuel. Les constantes que j'ai mentionnées dans l'article font référence à des constantes déclarées à l'aide de const.

Bases
L'espace de noms divise le code en différents espaces (régions). Les noms des constantes, des fonctions et des classes dans chaque espace (pour être paresseux, je les appellerai éléments ci-dessous) ne s'affectent pas les uns les autres. . C'est un peu similaire au concept d'« encapsulation » que nous mentionnons souvent.

Pour créer un espace de noms, vous devez utiliser le mot-clé namespace, comme ceci :
Copiez le code comme suit :

<?php//创建一个名为&#39;Article&#39;的命名空间namespace Article;?>

Copier après la connexion

Il est à noter que le premier espace de noms du le fichier de script actuel précède Il ne peut y avoir de code, l'écriture suivante est fausse :
Copiez le code comme suit :

//Exemple 1
//Écrivez du code logique devant le script

<?php$path = "/";class Comment { }namespace Article;?>

Copier après la connexion

//Exemple 2
//Certains caractères sont affichés devant le script

<html></html><?php
    namespace Article;?>

Copier après la connexion

Pourquoi voulez-vous dire le premier espace de noms ? Parce que plusieurs espaces de noms peuvent être créés dans le même fichier de script.

J'ai créé deux espaces de noms ci-dessous, et ajouté un élément de classe Comment à chacun de ces deux espaces :
Copiez le code comme suit :

<?php//创建一个名为&#39;Article&#39;的命名空间namespace Article;//此Comment属于Article空间的元素class Comment { }//创建一个名为&#39;MessageBoard&#39;的命名空间namespace MessageBoard;//此Comment属于MessageBoard空间的元素class Comment { }?>

Copier après la connexion

Entre différents espaces Vous ne pouvez pas appeler directement d'autres éléments, vous devez utiliser la syntaxe de l'espace de noms :
Copiez le code comme suit :

<?phpnamespace Article;class Comment { }namespace MessageBoard;class Comment { }//调用当前空间（MessageBoard）的Comment类$comment = new Comment();//调用Article空间的Comment类$article_comment = new \Article\Comment();?>

Copier après la connexion

Comme vous pouvez le voir, lors de l'appel de la classe Comment dans l'espace article dans l'espace MessageBoard, utilisez A syntaxe comme un chemin de fichier : Nom de l'espace Nom de l'élément

À l'exception des classes, l'utilisation des fonctions et des constantes est la même. Ci-dessous, j'ai créé de nouveaux éléments pour les deux espaces et les ai placés dans l'espace MessageBoard. sont sortis en .
Copiez le code comme suit :

<?phpnamespace Article;const PATH = &#39;/article&#39;;function getCommentTotal() {
    return 100;
}class Comment { }namespace MessageBoard;const PATH = &#39;/message_board&#39;;function getCommentTotal() {
    return 300;
}class Comment { }//调用当前空间的常量、函数和类echo PATH; ///message_boardecho getCommentTotal(); //300$comment = new Comment();//调用Article空间的常量、函数和类echo \Article\PATH; ///articleecho \Article\getCommentTotal(); //100$article_comment = new \Article\Comment();?>

Copier après la connexion

Ensuite, j'ai obtenu les données des éléments de l'espace Article.

Sous-espace
La syntaxe d'appel de l'espace de noms est comme un chemin de fichier, ce qui est logique. Elle nous permet de personnaliser les sous-espaces pour décrire la relation entre chaque espace.

Désolé, j'ai oublié de mentionner que les deux modules article et message board sont en fait dans le même projet de blog. Si vous utilisez des espaces de noms pour exprimer leur relation, c'est comme ceci :
Copiez le code comme suit :

<?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();?>

Copier après la connexion

De plus, les sous-espaces peuvent également définir de nombreux niveaux, comme BlogArticleArchivesDate

Espace Public
J'ai un fichier de script common_inc.php, qui contient quelques fonctions et classes utiles :
Copiez le code comme suit :

<?phpfunction getIP() { }class FilterXSS { }?>

Copier après la connexion

Introduisez ce script dans un espace de noms, le script The les éléments n'appartiendront pas à cet espace de noms. Si aucun autre espace de noms n'est défini dans ce script, ses éléments seront toujours dans l'espace public :
Copiez le code comme suit :

<?phpnamespace Blog\Article;//引入脚本文件include &#39;./common_inc.php&#39;;$filter_XSS = new FilterXSS(); //出现致命错误：找不到Blog\Article\FilterXSS类$filter_XSS = new \FilterXSS(); //正确?>

Copier après la connexion

La façon d'appeler l'espace public est d'ajouter directement avant le nom de l'élément C'est tout, sinon l'analyseur PHP pensera que je veux appeler l'élément sous l'espace courant. En plus des éléments personnalisés, il inclut également les éléments propres à PHP, qui appartiennent tous à l'espace public.

Je voudrais mentionner qu'en fait, les fonctions et constantes de l'espace public peuvent être appelées normalement sans les ajouter (je ne comprends pas pourquoi PHP fait cela), mais afin de distinguer correctement les éléments, il est recommandé ajouter

lors de l'appel de fonctions.

Terminologie des noms
Avant de parler d'alias et d'importations, vous devez connaître la terminologie des trois noms d'espaces et comment PHP les analyse. La documentation officielle est très bonne, donc je viens de l'utiliser.

1. Nom non qualifié ou nom de classe sans préfixe, tel que $comment = new Comment();. Si l'espace de noms actuel est BlogArticle, Comment sera analysé comme BlogArticleComment. Si le code utilisant Comment ne contient du code dans aucun espace de noms (dans l'espace global), le Comment sera analysé comme un Commentaire.

2.限定名称，或包含前缀的名称，例如 $comment = new Article\Comment();。如果当前的命名空间是Blog，则Comment会被解析为Blog\Article\Comment。如果使用Comment的代码不包含在任何命名空间中的代码（全局空间中），则Comment会被解析为Comment。

3.完全限定名称，或包含了全局前缀操作符的名称，例如 $comment = new \Article\Comment();。在这种情况下，Comment总是被解析为代码中的文字名(literal name)Article\Comment。

其实可以把这三种名称类比为文件名（例如 comment.php）、相对路径名（例如 ./article/comment.php）、绝对路径名（例如 /blog/article/comment.php），这样可能会更容易理解。

我用了几个示例来表示它们：
复制代码代码如下:

<?php//创建空间Blognamespace 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的子空间Articlenamespace Blog\Article;class Comment { }?>

Copier après la connexion

其实之前我就一直在使用非限定名称和完全限定名称，现在它们终于可以叫出它们的名称了。

别名和导入
别名和导入可以看作是调用命名空间元素的一种快捷方式。PHP并不支持导入函数或常量。

它们都是通过使用use操作符来实现：
复制代码代码如下:

<?phpnamespace 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();?>

Copier après la connexion

我注意到，如果导入元素的时候，当前空间有相同的名字元素将会怎样？显然结果会发生致命错误。

例：
复制代码代码如下:

<?phpnamespace 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发生冲突，程序产生致命错误?>

Copier après la connexion

动态调用
PHP提供了namespace关键字和NAMESPACE魔法常量动态的访问元素，NAMESPACE可以通过组合字符串的形式来动态访问：
复制代码代码如下:

<?phpnamespace Blog\Article;const PATH = &#39;/Blog/article&#39;;class Comment { }//namespace关键字表示当前空间echo namespace\PATH; ///Blog/article$comment = new namespace\Comment();//魔法常量__NAMESPACE__的值是当前空间名称echo __NAMESPACE__; //Blog\Article//可以组合成字符串并调用$comment_class_name = __NAMESPACE__ . &#39;\Comment&#39;;$comment = new $comment_class_name();?>

Copier après la connexion

字符串形式调用问题

上面的动态调用的例子中，我们看到了字符串形式的动态调用方式，如果要使用这种方式要注意两个问题。

使用双引号的时候特殊字符可能被转义
复制代码代码如下:

<?phpnamespace Blog\Article;class name { }//我是想调用Blog\Article\name$class_name = __NAMESPACE__ . "\name"; //但是\n将被转义为换行符$name = new $class_name(); //发生致命错误?>

Copier après la connexion

不会认为是限定名称

PHP在编译脚本的时候就确定了元素所在的空间，以及导入的情况。而在解析脚本时字符串形式调用只能认为是非限定名称和完全限定名称，而永远不可能是限定名称。
复制代码代码如下:

<?phpnamespace Blog;//导入Common类use Blog\Article\Common;//我想使用非限定名称调用Blog\Article\Common$common_class_name = &#39;Common&#39;;//实际会被当作非限定名称，也就表示当前空间的Common类，但我当前类没有创建Common类$common = new $common_class_name(); //发生致命错误：Common类不存在//我想使用限定名称调用Blog\Article\Common$common_class_name = &#39;Article\Common&#39;;//实际会被当作完全限定名称，也就表示Article空间下的Common类，但我下面只定义了Blog\Article空间而不是Article空间$common = new $common_class_name(); //发生致命错误：Article\Common类不存在namespace Blog\Article;class Common { }?>

Copier après la connexion

总结
我对PHP的命名空间刚刚接触，也不能随便给一些没有实践的建议。我个人认为命名空间的作用和功能都很强大，如果要写插件或者通用库的时候再也不用担心重名问题。不过如果项目进行到一定程度，要通过增加命名空间去解决重名问题，我觉得工作量不会比重构名字少。也不得不承认它的语法会对项目增加一定的复杂度，因此从项目一开始的时候就应该很好的规划它，并制定一个命名规范。