PHP命名空间使用指南_PHP namespace声明与调用方法

PHP命名空间用于解决类、函数、常量命名冲突，需在文件顶部声明，支持多级如AppControllers；用use导入后可简写调用；推荐遵循PSR-4规范并显式调用全局函数。

PHP命名空间（namespace）是用来解决类、函数、常量等命名冲突问题的核心机制，尤其在大型项目或使用多个第三方库时必不可少。正确声明和调用命名空间，能让代码结构更清晰、可维护性更强。

如何声明命名空间

命名空间必须放在文件最顶部（可选的declare语句之后、任何PHP代码之前），且一个文件通常只定义一个主命名空间。

• 基本语法：namespace 后跟命名空间名称，以分号结尾
• 支持多级命名，用反斜杠 分隔，如 namespace AppControllers;
• 可以嵌套子命名空间，但不推荐在单个文件中多次使用 namespace 切换（PHP 7.4+ 支持同一文件多个命名空间，但易混乱，建议避免）
• 全局命名空间用 namespace {}; 表示（即无名称），此时所有类/函数默认属于全局空间

如何在当前文件中使用其他命名空间

用 use 关键字导入外部命名空间中的类、接口、函数或常量，简化后续调用。

• 导入类：use AppModelsUser;
• 起别名：use AppModelsUser as UserModel;
• 导入函数（PHP 5.6+）：use function Helpersormat_date;
• 导入常量（PHP 5.6+）：use const HelpersMAX_RETRY;
• 注意：use 只影响当前文件，不具传递性；它不是“包含文件”，而是“取别名”

如何调用命名空间中的内容

有三种常见方式：完全限定名、相对调用、以及通过 use 导入后直接使用。

标签： php composer app