为了创建您的项目,你必须先下载并解压缩Zend Framework。
最简单的方法是安装 Zend Server 。Zend Server已经有 Mac OSX,Windows,Fedora Core,和 Ubuntu 版本,以及一个与大多数 Linux 发行版本相兼容通用的安装包。
安装 Zend Server 以后,Zend Framework 文件可能会在 Mac OSX 和 Linux 下的 /usr/local/zend/share/ZendFramework,在 Windows 下 C:\Program Files\Zend\ZendServer\share\ZendFramework 找到。 Zend Framework 已经被包括include_path 。
如果不打算安装 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)。
导航到你想建立项目的文件夹。
执行下列操作:
- % zf create project quickstart
运行此命令将创建基本的网站结构,包括您的初始化的控制器和视图。
该树如下所示:
- quickstart
- |-- application
- | |-- Bootstrap.php
- | |-- configs
- | | `-- application.ini
- | |-- controllers
- | | |-- ErrorController.php
- | | `-- IndexController.php
- | |-- models
- | `-- views
- | |-- helpers
- | `-- scripts
- | |-- error
- | | `-- error.phtml
- | `-- index
- | `-- index.phtml
- |-- library
- |-- public
- | |-- .htaccess
- | `-- index.php
- |-- tests
- |-- application
- | `-- bootstrap.php
- |-- library
- | `-- bootstrap.php
- | `-- phpunit.xml
此时,如果您没有将 Zend Framework 包括到 include_path, 我们建议,把下载以后解压缩的 zend framework 目录下的 library/ 里面的 Zend/ 整个文件夹,复制到你刚才建立的项目下的 library/ 目录中。或者建立一个软链接。
在这2种情况下,你需要递归复制或者在 library/Zend 目录和你的Zend Framework 项目的文件目录之间创建软连接。
在Unix类系统,这将类似于下列之一:
- # Symlink:
- % cd library; ln -s path/to/ZendFramework/library/Zend .
- # Copy
- % cd library; cp -r path/to/ZendFramework/library/Zend .
在Windows系统上,通过文件浏览器很容易办到这些。
现在,项目已经创建,下面主要目标将是理解:bootstrap, configuration(设置), action controllers(行为控制器), 和 views(视图)。
The Bootstrap
Bootstrap 类定义了什么资源和组件将要初始化。
默认情况下,Zend Framework的前端控制器 被初始化,它使用 application/controllers/ 作为默认目录,在其中寻找行动控制器(更多稍后)。
类如下所示:
- // application/Bootstrap.php
- class Bootstrap extends Zend_Application_Bootstrap_Bootstrap
- {
- }
// application/Bootstrap.php class Bootstrap extends Zend_Application_Bootstrap_Bootstrap { }
正如你所看到的,开始并不需要做多少事情。
配置
虽然 Zend Framework 本身不需要配置,你经常需要配置您的应用程序。
默认配置是放置在 application/configs/application.ini 文件中,这个文件了包含一些基本的指令设置你的 PHP 环境(例如,打开还是关闭错误报告),指示到 bootstrap 类的路径(以及它的类的名称),以及到行为控制器的路径。
它看起来如下:
- ; application/configs/application.ini
- [ production ]
- phpSettings. display_startup_errors = 0
- phpSettings. display_errors = 0
- includePaths. library = APPLICATION_PATH "/../library"
- bootstrap. path = APPLICATION_PATH "
- bootstrap. class = "Bootstrap"
- appnamespace = "Application"
- resources.frontController. controllerDirectory = APPLICATION_PATH "/controllers"
- resources.frontController.params. displayExceptions = 0
- [ staging : production ]
- [ testing : production ]
- phpSettings. display_startup_errors = 1
- phpSettings. display_errors = 1
- [ development : production ]
- phpSettings. display_startup_errors = 1
- phpSettings. display_errors = 1
有关此文件有几点应该指出的。
首先,在使用的 INI 格式的配置,你可以直接引用常量和扩展他们; APPLICATION_PATH 实际上是一个常量。
另外注意到,被定义的这几个部分:production, staging, testing, and development。
后三个继承自“production”环境。
这是组织配置一个有效的方法,从而确保在应用程序开发的每一阶段都能有合适的配置。
Action Controllers
您的应用程序的行为控制器 包含您的应用程序的工作流程,并把您的请求映射到适当的模型和视图。
一个行为控制器应该有一个或多个方法以“Action”结尾;然后可以通过网络请求这些方法。
默认情况下,Zend Framework 的 URL 遵循 /constroller/action 结构,其中“controller”映射行为控制器的名称(除去“Controller”后缀)同时“action”映射到 action 的方法(除去 “Action”后缀)。
通常,你总是需要一个 IndexController,这是一个 fallback 控制器,它也服务该网站的主页,同时需要一个 ErrorController,这是用来处理,如 HTTP 404 错误(未找到控制器或行动)和 HTTP 500 错误(应用程序错误)这些事情。
默认 IndexController 如下:
- // application/controllers/IndexController.php
- class IndexController extends Zend_Controller_Action
- {
- public function init ( )
- {
- /* Initialize action controller here
- }
- public function indexAction ( )
- {
- // action body <br />
- }
- }
<wbr>// application/controllers/IndexController.php <wbr> <wbr>class IndexController extends Zend_Controller_Action <wbr>{ <wbr> <wbr>public function init ( ) <wbr> <wbr>{ <wbr> <wbr>/* Initialize action controller here <wbr>} <wbr> <wbr>public function indexAction ( ) <wbr> <wbr>{ <wbr> <wbr>// action body <br /> <wbr>} <wbr> <wbr>} <wbr>
默认ErrorController如下:
- // 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 ;
- }
- }
<wbr>// application/controllers/ErrorController.php <wbr> <wbr>class ErrorController extends Zend_Controller_Action <wbr>{ <wbr> <wbr>public function errorAction ( ) <wbr> <wbr>{ <wbr> <wbr>$errors = $this ->_getParam ( 'error_handler' ) ; <wbr> <wbr>switch ( $errors -> type ) { <wbr> <wbr>case Zend_Controller_Plugin_ErrorHandler:: EXCEPTION_NO_ROUTE : <wbr>case Zend_Controller_Plugin_ErrorHandler:: EXCEPTION_NO_CONTROLLER : <wbr>case Zend_Controller_Plugin_ErrorHandler:: EXCEPTION_NO_ACTION : <wbr>// 404 error -- controller or action not found <wbr>$this -> getResponse ( ) -> setHttpResponseCode ( 404 ) ; <wbr>$this -> view -> message = 'Page not found' ; <wbr>break ; <wbr> <wbr>default : <wbr> <wbr>// application error <wbr> <wbr>$this -> getResponse ( ) -> setHttpResponseCode ( 500 ) ; <wbr>$this -> view -> message = 'Application error' ; <wbr>break ; <wbr>} <wbr> <wbr>$this -> view -> exception = $errors -> exception ; <wbr>$this -> view -> request = $errors -> request ; <wbr>} <wbr> <wbr>} <wbr>
您会注意到,(1)IndexController没有包含真正的代码,并且(2)ErrorController 对一个 "view"的属性做了一个引用。这就使我们很好地进入下一个议题。
视图
在 Zend Framework 中视图是用老式的PHP写成。
视图脚本放置在 application/views/scripts/,他们在那里继续使用控制器名称进行分类。
就我们这个例子而言,我们有一个 IndexController 和 ErrorController,所以,我们在我们的视图脚本目录,相应的就有 index/ 和 error/ 子目录。
在这些子目录,你可以查找和创建与每一个行为控制器对应的视图脚本,在默认情况下,我们于是有了视图脚本 index/index.phtml 和 error/error.phtml。
视图脚本可以包含任何您想要标记,并使用 <?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 文件的内容放到你的服务器配置里面并禁止这样做。第三,注意 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);你应该能看到一个欢迎页面。