##1.21.1 PhalApi自动加载的机制
首先,PhalApi的自动加载是简单的;其次,PhalApi不强制只使用我们框架的机制。
有些框架,单单在类文件的自动加载这一块就弄得非常复杂,以致开发同步需要在这些框架添加一些自己的类代码时,往往不知要怎么引入!甚至明明用引入了却又不见得生效!
而在PhalApi,我们则是: **简单、统一、规范**。
##1.21.2 PEAR包命名规范
PEAR包的类文件路径和类名映射非常简单,如下图:
![0215](http://webtools.qiniudn.com/20150411005257_cec1c175fa70c8bc904389be30712bc3)
或者查看(里面有很好的代码风格编写说明): [Autoloading Standard](http://www.php-fig.org/psr/psr-0/)
而PhalApi则更简单,我们暂时还不使用命名空间,所以namespace这一块省去。例如:
```javascript
Api_User
Domain_User
Model_User
```
对应以下路径的文件:
```javascript
.
|-- Api
| `-- User.php
|-- Domain
| `-- User.php
|-- Model
| `-- User.php
```
再举一个模拟的示例,如类Api_Game_User_Equitment对应以下文件路径:
```javascript
./Api/Game/User/Equitment.php
```
此外,还需注意区分大小写。
##1.21.3 挂靠式自动加载
然后在我们准备了这些类和文件后,我们怎么才能让这些类被框架所自动加载呢?
我们提供的方式是: **挂靠式自动加载** 。
熟悉Linux系统的同学可能很容易明白,还没接触到Linux的同学也是可以很快理解的。这里稍微说明一下。
所谓的 **挂靠** 就是把你代码的目录放在项目的目录下(或者其他任何一个地方),随后简单地将此目录添加到自动加载器即可。如上面的:
```javascript
DI()->loader->addDirs('Demo');
```
当有多个目录时,可以这样:
```javascript
DI()->loader->addDirs(array('Demo', 'Library'));
```
需要注意的是,上面相对路径的都需要放置在应用项目的目录API_ROOT下面。如果是单个文件的引入,则可以使用绝对路径。下面分别简单说明。
###(1)相对路径的目录路径挂靠
通过PhalApi_Loader::addDirs()方式挂靠的路径,都是强制在目录API_ROOT下面,即下面的三种方式是等效的(在Linux系统上):
```
//路径:API_ROOT/Demo
DI()->loader->addDirs('Demo');
//路径:API_ROOT/./Demo
DI()->loader->addDirs('./Demo');
//路径:API_ROOT/Demo
DI()->loader->addDirs('/Demo');
```
如果需要挂靠的目录不在项目目录下,在Linux可以通过软链来解决。
###(2)单个文件允许绝对路径引入
对于单个文件的引入,可以通过PhalApi_Loader::loadFile()来引入。注意以下两种写法的区别:
```
//路径:API_ROOT/Demo/Tool.php
DI()->loader->loadFile('Demo/Tool.php');
//路径:/path/to/Demo/Tool.php
DI()->loader->loadFile('/path/to/Demo/Tool.php');
```
- 欢迎使用PhalApi!
- 接口,从简单开始!
- [1.1]-下载与安装
- [1.2]-创建一个自己的项目
- [1.3]-在线体验
- [1.4]-文档、帮助和官网
- [1.10]-对PhalApi框架的抉择
- [1.11]-快速入门(backup)
- [1.12]-参数规则:接口参数规则配置
- [1.13]-统一的接口请求方式:_sevice=XXX.XXX
- [1.14]-统一的返回格式和结构:ret-data-msg
- [1.15]-数据库操作:基于NotORM的使用及优化
- [1.16]-配置读取:内外网环境配置的完美切换
- [1.17]-日记纪录:简化版的日记接口
- [1.18]-快速函数:人性化的关怀
- [1.19]-DI服务速查:各资源服务一览表
- [1.20]-DB操作:数据库基本操作速查
- [1.21]-类的自动加载:遵循PEAR包的命名规范
- [1.22]-签名验证:自定义签名规则
- [1.23]-请求和响应:GET和POST两者皆可得及超越JSON格式返回
- [1.24]-缓存策略:更灵活地可配置化的多级缓存
- [1.25]-国际化翻译:为走向国际化提前做好翻译准备
- [1.26]-数据安全:数据对称加密方案
- [1.27]-精益开发:更富表现力的Model层和重量级数据获取的应对方案
- [1.28]-COOKIE:对COOKIE原生态的支持及记忆加密升级版
- [1.29]-开放与封闭:多入口和统一初始化
- [1.30]-保持的力量:接口开发最佳实践
- [1.31]-新型计划任务:以接口形式实现的计划任务
- [2.11]-核心思想:DI依赖注入-让资源更可控
- [2.12]-海量数据:可配置的分库分表
- [2.13]-接口调试:在线SQL语句查看与性能优化
- [2.14]-测试驱动开发:意图导向编程下的接口开发
- [2.15]-演进:新型计划任务续篇
- [2.16]-领域驱动设计:应对复杂领域业务的Domain层
- [2.17]-微服务:Api接口服务层
- [2.18]-定制化:资源服务的再实现
- [2.19]-扩展库:可重用的扩展类库
- [2.20]-约定编程:架构明显的编程风格
- [2.21]-服务器统一部署方案简明版:CentOs---Nginx---php-fpm---MySql-[--Memcached]
- [2.22]-更多工具:精益项目和团队建设
- [3.1]-扩展类库:微信开发
- [3.2]-扩展类库:代理模式下phprpc协议的轻松支持
- [3.3]-扩展类库:基于PHPMailer的邮件发送
- [3.4]-扩展类库:优酷开放平台接口调用
- [3.5]-扩展类库:七牛云存储接口调用
- [3.6]-扩展类库:新型计划任务
- [3.8]-扩展类库:用户、会话和第三方登录集成
- [3.9]-扩展类库:swoole支持下的长链接和异步任务实现
- [3.11]-扩展类库:基于FastRoute的快速路由
- [4.2]-开发实战2:模拟优酷开放平台接口项目开发
- [4.3]-开发实战3:一个简单的小型项目开发(奔跑吧兄弟投票活动)
- [5.1]-架构与思想:PhalApi核心设计和思想解读
- [5.2]-杂谈:扯一些PhalApi的前世和今生
- [5.3]-框架总结:术语表和PHP开发建议
- [5.4]-许可
- [5.5]-联系和加入我们
- [5.6]-更新日记
- [5.8]-致框架贡献者:加入PhalApi开源指南
- [6.1]-基于接口查询语言的SDK包
- [6.2]-SDK包(JAVA版)
- [6.3]-SDK包(PHP版)
- [6.4]-SDK包(Objective-C版)
- [6.5]-SDK包(javascript版)
- [6.6]-SDK包(Ruby版)
- [8.1]-PhalApi视频教程
- 附录1:接口文档参考模板