PHP命名空间

PHP命名空间的使用及注意要点

PHP 命名空间是一种组织和管理 PHP 代码的方式。它提供了一种避免命名冲突的机制，特别是当多个开发者或多个代码库在同一个应用程序中使用相同的类名、函数名或常量名时。简单理解就好像操作系统目录文件的概念，同一目录里不能存在两个相同的文件。这个原理就应用到PHP程序设计领域就是命名空间的概念。

基本使用

默认情况下常量、类和函数名都放在全局空间下。命名空间通过 namespace 来声明。

注意：

1. namespace 必须定义在文件头部，并在declare(strict_types=1) 语句下面。

2. 实际上，当你在 PHP 代码中没有显式指定命名空间时，会使用默认的全局命名空间，也称为全局作用域。全局作用域中的类、函数和常量可以在任何地方被访问和使用，不需要使用命名空间限定符。

3. 如果命名空间中的函数或常量未定义，将会使用全局命名空间。

declare(strict_types=1) //严格模式
namespace Person;

class Person {
    // 类的定义
}

function myFunction() {
    // 函数的定义
}

const MY_NAME = '张飞';

//使用方法
use MyNamespace\Person;
use function Person\myFunction;
use const Person\MY_NAME;

$obj = new Person();  // 使用完全限定的类名
myFunction();          // 使用完全限定的函数名
echo MY_NAME;      // 使用完全限定的常量名

引用的方式

使用 use 关键字：通过 use 关键字来导入特定的类、函数或常量，以便在当前文件中直接使用。

use MyNamespace\MyClass;
use function MyNamespace\myFunction;
use const MyNamespace\MY_CONSTANT;

$obj = new MyClass();  // 使用导入的类
myFunction();          // 使用导入的函数
echo MY_CONSTANT;      // 使用导入的常量

使用完全限定的名称：如果没有使用 use 关键字导入命名空间，也可以通过完全限定的名称来访问命名空间中的类、函数和常量。

$obj = new MyNamespace\MyClass();  // 使用完全限定的类名
MyNamespace\myFunction();          // 使用完全限定的函数名
echo MyNamespace\MY_CONSTANT;      // 使用完全限定的常量名

使用别名（Alias）：可以通过 use 关键字为命名空间或类创建别名，以便在代码中使用更简短的名称。

use MyNamespace\MyClass as MyClassAlias;
use MyNamespace\myFunction as functionAlias;
use MyNamespace\MY_CONSTANT as CONSTANT_ALIAS;

$obj = new MyClassAlias();  // 使用别名类名
functionAlias();            // 使用别名函数名
echo CONSTANT_ALIAS;        // 使用别名常量名

注意：

多个引入，可以使用多行 use 或用逗号分隔多个类（空间）形式处理多个导入的情况，并使用逗号分隔。

自动加载

在 PHP 中，可以通过使用 spl_autoload_register() 函数来注册自定义的自动加载函数。该函数接受一个回调函数作为参数，当 PHP 遇到未定义的类时，会调用该回调函数来加载类文件。自动加载能够根据类的命名约定自动找到并加载所需的类文件，提高了代码的可维护性和可扩展性。

spl_autoload_register(function ($className) {
    // 转换命名空间分隔符为目录分隔符
    $filePath = str_replace('\\', '/', $className) . '.php';

    if (file_exists($filePath)) {
        require_once($filePath);
    }
});

注意：

自动加载函数的实现可以根据你的项目结构和命名约定进行调整。

例如，你可以将类文件存放在特定目录下，或者使用其他命名约定来匹配类名和文件路径。

推荐使用composer管理项目和自动加载

composer的安装搭建可以自行研究，这不难~

使用方法：

1、进入项目的根目录，并初始化

composer init

2、修改配置文件

个性 composer.json 配置文件，其中 autoload配置项是自动加载设置。

• files 是自动加载文件列表，适合于加载函数
• psr-4 自动加载命名空间与目录对应关系
  
  修改配置文件后执行 composer install 生成 vendor，如果修改过配置文件需要执行 composer update。

3、配置

在项目中使用以下代码即可完成自动加载。

include 'vendor/autoload.php';
改配置文件后执行 `composer install` 生成 vendor，如果修改过配置文件需要执行 `composer update`。



**3、配置**

在项目中使用以下代码即可完成自动加载。

```text
include 'vendor/autoload.php';