1.21.1 PhalApi自动加载的机制

首先，PhalApi的自动加载是简单的；其次，PhalApi不强制只使用我们框架的机制。

有些框架，单单在类文件的自动加载这一块就弄得非常复杂，以致开发同学需要在这些框架添加一些自己的类代码时，往往不知要怎么引入！甚至明明用引入了却又不见得生效！

而在PhalApi，我们则是： 简单、统一、规范。

1.21.2 PEAR包命名规范

PEAR包的类文件路径和类名映射非常简单，如下图：

0215或者查看（里面有很好的代码风格编写说明）： Autoloading Standard

而PhalApi则更简单，我们暂时还不使用命名空间，所以namespace这一块省去。例如： 

  1. Api_User
  2. Domain_User
  3. Model_User

对应以下路径的文件：

  1. .
  2. |-- Api
  3. |   `-- User.php
  4. |-- Domain
  5. |   `-- User.php
  6. |-- Model
  7. |   `-- User.php

再举一个模拟的示例，如类Api_Game_User_Equitment对应以下文件路径：

  1. ./Api/Game/User/Equitment.php

此外，还需注意区分大小写。

1.21.3 挂靠式自动加载

然后在我们准备了这些类和文件后，我们怎么才能让这些类被框架所自动加载呢？

我们提供的方式是： 挂靠式自动加载 。

熟悉Linux系统的同学可能很容易明白，还没接触到Linux的同学也是可以很快理解的。这里稍微说明一下。

所谓的 挂靠 就是把你代码的目录放在项目的目录下（或者其他任何一个地方），随后简单地将此目录添加到自动加载器即可。如上面的：

  1. DI()->loader->addDirs('Demo');

当有多个目录时，可以这样：

  1. DI()->loader->addDirs(array('Demo', 'Demo1', 'Demo2'));

需要注意的是，上面相对路径的都需要放置在应用项目的目录API_ROOT下面。如果是单个文件的引入，则可以使用绝对路径。下面分别简单说明。

(1)相对路径的目录路径挂靠

通过PhalApi_Loader::addDirs()方式挂靠的路径，都是强制在目录API_ROOT下面，即下面的三种方式是等效的（在Linux系统上）： 

  1. //路径：API_ROOT/Demo
  2. DI()->loader->addDirs('Demo');
  4. //路径：API_ROOT/./Demo
  5. DI()->loader->addDirs('./Demo');
  7. //路径：API_ROOT/Demo
  8. DI()->loader->addDirs('/Demo');

如果需要挂靠的目录不在项目目录下，在Linux可以通过软链来解决。

(2)单个文件允许绝对路径引入

对于单个文件的引入，可以通过PhalApi_Loader::loadFile()来引入。注意以下两种写法的区别： 

  1. //路径：API_ROOT/Demo/Tool.php
  2. DI()->loader->loadFile('Demo/Tool.php');
  4. //路径：/path/to/Demo/Tool.php
  5. DI()->loader->loadFile('/path/to/Demo/Tool.php');

原文: https://www.phalapi.net/wikis/1-21.html