关于 Zend 框架 MVC 应用程序项目结构的建议

概述

许多开发者寻找在一个相对灵活的环境中，对于一个 Zend 框架项目最好的项目结构的指南。一个灵活的环境是，开发者可以在这个环境中执行他们的文件系统和 web 服务器设置以达到最理想化的项目结构来运行和保护他们的应用程序。默认的项目结构将假设开发者拥有这样的灵活性。

以下的目录结构被设计成最大扩展性来适应复杂的项目，同时对于更简单的要求，为项目提供了一简单的文件夹和文件子集。这个结构不需要转化就可以同时作用于有 modular 和没有 modular 的 Zend 框架应用程序。.htaccess 文件要求在 web 服务器中设置 URL 重写功能（重写设置指南中有介绍，在附件中有介绍）。

这个项目结构的目标不是支持所有的 Zend 框架项目要求。被 Zend_Tool 所使用的默认的项目文档反映了这个目录结构，但是不被这个结构支持的应用程序应使用一个定制的项目文档。

建议项目目录结构

以下描述了列出的目录的使用方法。

• application/：这个目录包括了你的应用程序。它会成为 MVC 系统的家，同时包括配置，使用的服务，和你的 bootstrap 文件。
  • configs/：全应用程序范围的配置目录。
  • controllers/，models/，和 views/：这些目录用于默认的控制器，模型或者视图目录。在应用程序的内部拥有这三个目录，对于开始一个简单的项目，和开始一个拥有全局 controllers/models/views的 modular 项目提供了最好的模板。
  • controllers/helpers/：这些目录将包括行为控制器。行为控制器将会在默认的模式中被命名为 Controller_Helper_，在其它的模式中被命名为 _Controller_Helper。
  • layouts/：这个是基于 MVC 模板的模板目录。由于 Zend_Layout 适用于基于 MVC 和不基于 MVC 的模板，这个目录的位置反映了模板和控制器不是1:1的关系，同时独立于 views/ 内的模板。
  • modules/：模式允许一个开发者把一套相关的控制器分组成一个逻辑组织的小组。模式下的结构将看起来和应用程序的目录下的结构很象。
  • services/：这个目录是用来放置由你的应用程序提供的应用程序特殊的 web 服务文件，或者为你的模式应用的一个服务层（Service Layer）。
  • Bootstrap.php：这个文件是你的应用程序的进口，而且它应该应用 Zend_Application_Bootstrap_Bootstrapper。这个文件的目的是为了启动应用程序，同时通过初始化组件使得组件对于应用程序可用。
• data/：这个目录提供了存储应用程序数据的地方，这些数据是多变的可能也是临时的。这个目录中的数据紊乱将可能导致应用程序的失败。同时，对于一个 subversion repository，这个目录的信息可以会或者不会被忽视。在这个目录的文件包括对话文件，缓存文件，sqlite 数据库，日志和索引。
• docs/：这个目录是用于存放应用程序所依靠的普通库文件，而且应该被包括到 PHP 的 include_paht 路径。开发者应该把他们的应用程序的库代码放到这个目录下，用一个独一无二的命名空间，遵从 PHP 手册中的 Userland Naming Guide 指引，如同 Zend 的库文件一样。这个目录可能还包括 Zend 框架本身；如果可能，你可能把它放在 library/Zend/。
• public/：这个目录包括你应用程序的全部公开文件（public files）。index.php 建立并唤起 Zend_Application，然后唤起 application/Bootstrap.php 文件，结果是分发前端控制器。你的 web 服务器的 web 根目录典型的被设置成这个目录。
• scripts/：这个目录包括维护和/或创建脚本。这些脚本可能包括命令行，cron，或者 phing 创建的脚本，在运行的时候不执行，但是对于应用程序的正常运转是不可少的。
• temp/：temp/ 文件夹是
• tests/：

模式结构

模式结构应该模仿建议项目结构中的 application/ 目录：

这些目录的目的在于保持和建议项目目录结构一样的结构。

重写设置指南

URL 重写是 HTTP 服务器的一个普通功能。然而，不同的 HTTP 服务器的重写规则和设置差别很大。以下是在写下这篇文章的时候应用比较多的 web 服务器的重写方法

Apaceh HTTP 服务器

所以的例子跟随使用 mod_rewrite，一个和 Apache 捆绑发行的官方模块。为了使用它，mod_rewrite 必须在编译的时候被包括或者被设置成 Dynamic Shared Object（DSO）。请查看与你版本相关的 Apache 文档来获得更多信息。

在一个虚拟主机内重写

以下的一个很基础的虚拟主机定义。这些规则把所有的请求导向 index.php，除了在 document_root 下找到一个匹配的文件。

注意 index.php 前面的斜线（“/”）；和 .htaccess 中的重写规则有不同。

在一个 .htaccess 文件中重写

以下是一个使用 mod_rewrite 的 .htaccess 文件样本。它和虚拟主机配置相似，除了它只指定重写规则，以及取消了 index.php 的前置斜线。

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} -s [OR]
RewriteCond %{REQUEST_FILENAME} -l [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^.*$ - [NC,L]
RewriteRule ^.*$ index.php [NC,L]

有许多种方法来配置 mod_rewriter； 如果你想要更多信息，看一下 Jayson Minard 的 >> Blueprint for PHP Applications: Bootstrapping。

Mircrosoft Internet Information 服务器

对于7.0版本的 IIS，拥有了一个标准的重写引擎。你可以使用以下的配置来创建合适的重写规则。