Protoss/目录结构

目录结构

上图显示的是基于Protoss项目的根文件夹的一种形式，也是虚拟主机用户最常用的一种方式。（但是我们推荐您使用更安全的目录结构，详见：更安全的目录结构。）

图中：

• index.php 入口文件

所有的访问都由该文件开始，除些文件以外所有的PHP代码都无法直接从浏览器访问，也这更加安全可靠。

• apps 项目代码目录
  • controller 控制器
  • model 模型
  • templates 模板/视图
• css CSS样式表目录
• javascript JavaScript代码目录

需要知道的几个目录： 项目目录(application dir) 指的是项目(或称应用程序)的控制器、模型、视图所存放的目录(即父目录) 根目录(root dir) 指的是存放框架、项目目录的目录 配置文件目录(config dir) 指的是存放配置文件的目录 缓存文件目录(cache dir) 指的是项目运行过程中所产生的临时文件存放目录

命名规范

Protoss的命名分为两种--常规命名和强制命名。 所谓常规命名，就是指一般情况下都会按照该命名方法的，而强制命名则指的特殊的命名方式，不同于常规命名。

常规命名

为了提高代码的可读性和可维护性，所有的代码都要按照常规命名方法存放，我们来看一个例子，下面是类Model_City的代码片段：

以apps/myappname(见左边,myappname实为您的项目目录名称)为应用程序目录，其下的目录可用于自动智能载入。

从该目录算起，以“文件夹名/[若干文件夹/]文件名.php”的形式存放类文件，类名一般是“文件夹名_[若干文件夹_]文件名”，如类文件中有包含“_”(下划线)，则每个下划线所分割的字符串要建立相应的文件夹进行存放，字符串段落越靠前则目录等级越高。

例如model目录中有city.php文件，则该文件中的类则是Model_City，请注意，一般来说，每个PHP文件中有且仅有一个类，并且每个类必须存放于一个专有的文件。

同理，若要建立类Model_User，则有model/user.php，如果是Model_User_Role,则有model/user/role.php。以此类推。

好，我们再来看看第二个例子：分页助手类“Helper_Pager”。

很明显的，这个文件会放到helper/pager.php这个文件中。

但是，这个是框架自带的类，我的类应该怎么放呢？

请看自动智能载入章节中的优先级说明。

强制命名

在项目的控制器和视图中，我们用到了强制命名。 强制命名是为了避免开发过程中的命名冲突，同样，也为了更好的标明文件作用的权限。

控制器文件的命名

详情请参阅控制器。

视图文件的命名

详情请参阅视图。