安装Zend Framework

安装Zend Framework

为了创建您的项目，你必须先下载并解压缩 Zend Framework。

最简单的方法是安装 Zend Server 。Zend Server 已经有 Mac OSX，Windows，Fedora Core，和 Ubuntu 版本的安装程序，以及一个适用于绝大多数的 Linux 发行版本的安装包。

安装 Zend Server 以后，可以在 Mac OSX 和 Linux 下的 /usr/local/zend/share/ZendFramework，在 Windows 下 C:\Program Files\Zend\ZendServer\share\ZendFramework 找到 Zend Framework 文件 。 include_path 路径已经被配置成包括了 Zend Framework 。

如果不打算安装 Zend Server，您可以 »下载Zend Framework的最新版本 然后解压缩。记住文件解压缩后所在位置。

解压缩以后,可以把 Zend Framework 文件夹下的 library/ 子目录添加到 php.ini 的 include_path 路径中。比如解压缩以后，Zend Framework 放置在 C:\program files\下，打开 php.ini，找到 include_path 这一行，如果前面有注释符，把注释符去掉，然后整句修改为：

include_path = ".;C:\program files\Zend Framework\library"

就是这样！ 框架现在已经安装并可以使用。

创建项目

注 ： zf 命令行工具

在您的 Zend Framework 文件夹中，有一个 bin/ 子目录，包含 zf.sh 脚本（适合 Unix 用户）和 zf.bat 脚本（适用 Windows 用户）。

记下这个脚本的绝对路径。

下文只要你看到的 zf 命令  ，请以绝对路径替换它。 比如你的 zf.bat 文件在 C:/program files/zend framework/bin/zf.bat，那么下面只要是 zf 的命令，就用 C:/program files/zend framework/bin/zf.bat 替换。

在 Unix 系统，您可以把 zf 添加到 shell： alias zf.sh=path/to/ZendFramework/bin/zf.sh .

如果您对建立 zf   命令行工具有疑问，请参考 手册 。

打开一个终端（在 Windows 中， Start -> Run   ，然后使用 cmd）。

导航到你想建立项目的文件夹。

执行下列操作：

1.  % zf create project quickstart

运行此命令将创建网站的基本结构，以及最初的控制器和视图。

该树如下所示：

1.  quickstart
2.  |-- application
3.  |   |-- Bootstrap.php
4.  |   |-- configs
5.  |   |   `-- application.ini
6.  |   |-- controllers
7.  |   |   |-- ErrorController.php
8.  |   |   `-- IndexController.php
9.  |   |-- models
10.  |   `-- views
11.  |       |-- helpers
12.  |       `-- scripts
13.  |           |-- error
14.  |           |   `-- error.phtml
15.  |           `-- index
16.  |               `-- index.phtml
17.  |-- library
18.  |-- public
19.  |   |-- .htaccess
20.  |   `-- index.php
21.  |-- tests
22.      |-- application
23.      |   `-- bootstrap.php
24.      |-- library
25.      |   `-- bootstrap.php
26.      | `-- phpunit.xml

此时，如果您没有将 Zend Framework 包括到 include_path 路径中的话， 我们建议，把下载以后解压缩的 zend framework 目录下的 library/ 里面的 Zend/ 整个文件夹，复制到你刚才建立的项目下的 library/ 目录中。或者建立一个软链接。

在Unix类系统，这将类似于下列之一：

1.  # Symlink:
2.  % cd library; ln -s path/to/ZendFramework/library/Zend . 
3.  # Copy
4.  % cd library; cp -r path/to/ZendFramework/library/Zend .

在Windows系统上，通过文件浏览器很容易办到这些。

现在，项目已经创建，下面主要目标将是理解：bootstrap, configuration（设置）, action controllers（行为控制器）, 和 views（视图）。

 The Bootstrap

Bootstrap 类定义了什么资源和组件将要初始化。

默认情况下，Zend Framework 的前端控制器 被初始化，它使用 application/controllers/ 作为默认目录，在其中（application/controllers/）寻找行动控制器（详细内容将在后面介绍）。

类如下所示：

 

view plaincopy to clipboardprint?

1. // application/Bootstrap.php   
2.     
3. class Bootstrap extends Zend_Application_Bootstrap_Bootstrap   
4. {   
5. }   

// application/Bootstrap.php class Bootstrap extends Zend_Application_Bootstrap_Bootstrap { }

 

正如你所看到的，开始并不需要做多少事情。

 配置（Configuration）

虽然 Zend Framework 本身不需要配置，你经常需要配置您的应用程序。  

默认配置是放置在 application/configs/application.ini 文件中，这个文件了包含一些基本的指令用来设置你的 PHP 环境（例如，打开还是关闭错误报告），指示到 bootstrap 类的路径（以及类的名称），还有到行为控制器的路径。

它看起来如下：

1.  ; application/configs/application.ini
2.  [ production ]
3.  phpSettings. display_startup_errors = 0
4.  phpSettings. display_errors = 0
5.  includePaths. library = APPLICATION_PATH "/../library"
6.  bootstrap. path = APPLICATION_PATH "
7.  bootstrap. class = "Bootstrap"
8.  appnamespace = "Application"
9.  resources.frontController. controllerDirectory = APPLICATION_PATH "/controllers"
10.  resources.frontController.params. displayExceptions = 0
11.  [ staging : production ]
12.  [ testing : production ]
13.  phpSettings. display_startup_errors = 1
14.  phpSettings. display_errors = 1
15.  [ development : production ]
16.  phpSettings. display_startup_errors = 1
17.  phpSettings. display_errors = 1

有关此文件有几点应该指出的。

首先，当使用的 INI 风格的配置文件，你可以直接引用常量并且扩展他们; APPLICATION_PATH 就是一个常量。

另外注意到，被定义的这几个部分：production, staging, testing, 以及 development。

后三个继承自“production”环境。

这是组织配置的一个有效的方法，从而确保在应用程序开发的每一阶段都能有合适的配置。

 行为控制器（Action Controllers）

您的应用程序的行为控制器 包含您的应用程序的工作流程，并从事把您的请求映射到适当的模型和视图的工作。

一个行为控制器应该有一个或多个以“Action”结尾的方法;这些方法可以通过网络被请求。  

默认情况下，Zend Framework 的 URL 遵循 /constroller/action 结构，其中“controller”映射行为控制器的名称（除去“Controller”后缀）同时“action”映射到一个 action 的方法（除去 “Action”后缀）。

通常，你总是需要一个 IndexController，这是一个 fallback 控制器，它也服务该网站的主页；同时还需要一个 ErrorController，这是用来处理，如 HTTP 404 错误（未找到控制器或行动）和 HTTP 500 错误（应用程序错误）这些事情。

默认 IndexController 如下：

 

view plaincopy to clipboardprint?

1.  // application/controllers/IndexController.php     
2.  class IndexController extends Zend_Controller_Action    
3.  {     
4.  public function init ( )     
5.  {     
6.  /* Initialize action controller here   
7.  }     
8.  public function indexAction ( )     
9.  {     
10.  // action body <br />   
11.  }     
12.  }    

 // application/controllers/IndexController.php   class IndexController extends Zend_Controller_Action  {   public function init ( )   {   /* Initialize action controller here }   public function indexAction ( )   {   // action body <br /> }   } 

 

默认 ErrorController 如下：

 

view plaincopy to clipboardprint?

1.  // application/controllers/ErrorController.php     
2.  class ErrorController extends Zend_Controller_Action    
3.  {     
4.  public function errorAction ( )     
5.  {     
6.  $errors = $this ->_getParam ( 'error_handler' ) ;     
7.  switch ( $errors -> type ) {     
8.  case Zend_Controller_Plugin_ErrorHandler:: EXCEPTION_NO_ROUTE :   
9.  case Zend_Controller_Plugin_ErrorHandler:: EXCEPTION_NO_CONTROLLER :    
10.  case Zend_Controller_Plugin_ErrorHandler:: EXCEPTION_NO_ACTION :    
11.  // 404 error -- controller or action not found   
12.  $this -> getResponse ( ) -> setHttpResponseCode ( 404 ) ;    
13.  $this -> view -> message = 'Page not found' ;    
14.  break ;     
15.  default :     
16.  // application error      
17.  $this -> getResponse ( ) -> setHttpResponseCode ( 500 ) ;   
18.  $this -> view -> message = 'Application error' ;   
19.  break ;   
20.  }     
21.  $this -> view -> exception = $errors -> exception ;   
22.  $this -> view -> request = $errors -> request ;    
23.  }      
24.  }     

 // application/controllers/ErrorController.php   class ErrorController extends Zend_Controller_Action  {   public function errorAction ( )   {   $errors = $this ->_getParam ( 'error_handler' ) ;   switch ( $errors -> type ) {   case Zend_Controller_Plugin_ErrorHandler:: EXCEPTION_NO_ROUTE : case Zend_Controller_Plugin_ErrorHandler:: EXCEPTION_NO_CONTROLLER :  case Zend_Controller_Plugin_ErrorHandler:: EXCEPTION_NO_ACTION :  // 404 error -- controller or action not found $this -> getResponse ( ) -> setHttpResponseCode ( 404 ) ;  $this -> view -> message = 'Page not found' ;  break ;   default :   // application error    $this -> getResponse ( ) -> setHttpResponseCode ( 500 ) ; $this -> view -> message = 'Application error' ; break ; }   $this -> view -> exception = $errors -> exception ; $this -> view -> request = $errors -> request ;  }   } 

 

您会注意到，（1）IndexController没有包含真正的代码，并且（2）ErrorController 引用了一个 "view"属性。这就使我们很好地进入下一个议题。

 视图

在 Zend Framework 中视图是用老式的PHP写成。  

视图脚本放置在 application/views/scripts/，他们在那里继续使用控制器名称进行分类。

就我们这个例子而言，我们有一个 IndexController 和 ErrorController，所以，我们在我们的视图脚本目录，相应的就有 index/ 和 error/ 子目录。  

在这些子目录，你可以查找和创建与每一个行为控制器对应的视图脚本，在本例中，我们有视图脚本  index/index.phtml 和 error/error.phtml。

视图脚本可以包含任何您想使用的 HTML 标签，并使用 <?php ?> 来插入 PHP 脚本。

以下是我们默认安装的 index/index.phtml 视图脚本：

error/error.phtml 视图脚本因为它使用了一些 PHP 条件语句显得更有趣：

创建一个虚拟主机

为了学习这个快速入门，我们假设你正在使用 Apache web 服务器。Zend Framework 在其它的服务器上同样工作良好－－包括微软的 IIS，lighttpd，nginx，以及更多－－但是绝大多数的开发者都至少熟悉 Apache，它很便捷的提供了 Zend Framework 所需要的目录结构和重写功能。

为了创建你的虚拟主机，你应该知道你的 httpd.conf 文件所在的位置，以及其它潜在配置文件所在的位置。一些通常的位置是：

      /etc/httpd/httpd.conf (Fedora, RHEL, and others)

      /etc/apache2/httpd.conf (Debian, Ubuntu, and others)

      /usr/local/zend/etc/httpd.conf (Zend Server on *nix machines)

      C:\Program Files\Zend\Apache2\conf (Zend Server on Windows machines)

在你的 httpd.conf（或者某些系统上的 httpd-vhosts.conf 文件）文件中，你将需要做两件事情。首先，确保 NameVirtualHost 已经被定义；通常的，你将把它设置成 *:80 这个值。其次，定义一个虚拟主机：

<VirtualHost *:80>
          ServerName quickstart.local
          DocumentRoot /到 quickstart 的路径/quickstart/public

          SetEnv APPLICATION_ENV "development"

          <Directory /到 quickstart 的路径/quickstart/public>
              DirectoryIndex index.php
              AllowOverride All
              Order allow,deny
              Allow from all
          </Directory>
</VirtualHost>

这里需要注意几件事。首先，注意 DocumentRoot 指向了我们项目的 public 子目录；这意味着只有在那个目录下的文件能被服务器所服务。其次，注意 AllowOverride，Order，和 Allow 指令；它们允许我们在我们的项目内使用 htaccess 文件，在开发环境下，这是一个好的做法，因为当你对你的站点改变指令的时候，它让你不必频繁的重启 web 服务器；然而，在实际生产环境中，你应该把你的 htaccess 文件的内容放到你的服务器配置里面，而不是使用 htaccess 文件。第三，注意 SetEnv 指令。我们在这里所做的是为了你的虚拟主机设置一个环境变量；这个变量将被 index.php 使用，设置成我们的 Zend Framework 应用程序 APPLICATION_ENV 常量的值。在实际生产中，你可以取消这个指令（在那种情况下，它的默认值将是 production）或者把它精确的设置为 production。

最后，你将需要添加一条记录到你的 hosts 文件中，和你在 ServerName 指令中设置的值相对应。在 *nix 系统中，这通常是 /etc/hosts；在 Windows，你通常会在 C:\WINDOWS\system32\drivers\etc 中找到它。不管是什么系统，这条记录看起来是这样的：

127.0.0.1 quickstart.local

启动你的 web 服务器（或者重启），你应该准备就绪了。

检查

在此时，你应该可以启动 Zend Framework 应用程序了。把你的浏览器指向你在之前设置好的服务器的名字（server name）；你应该能看到一个欢迎页面。