Zend Framework 1.10.1 快速入门之二:创建 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/ 目录,在这个目录中寻找动作控制器(有关动作控制器的详细内容将在后面介绍)。这个类看起来是这样的:

正如您所看到的,开始并不需要做太多事情。

 配置(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 如下:

默认 ErrorController 如下:

您会注意到,(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 视图脚本:

<!-- application/views/scripts/index/index.phtml -->
<style>
 
    a:link,
    a:visited
    {
        color: #0398CA;
    }
 
    span#zf-name
    {
        color: #91BE3F;
    }
 
    div#welcome
    {
        color: #FFFFFF;
        background-image: url(http://framework.zend.com/images/bkg_header.jpg);
        width:  600px;
        height: 400px;
        border: 2px solid #444444;
        overflow: hidden;
        text-align: center;
    }
 
    div#more-information
    {
        background-image: url(http://framework.zend.com/images/bkg_body-bottom.gif);
        height: 100%;
    }
 
</style>
<div id="welcome">
    <h1>Welcome to the <span id="zf-name">Zend Framework!</span><h1 />
    <h3>This is your project's main page<h3 />
    <div id="more-information">
        <p>
            <img src="http://framework.zend.com/images/PoweredBy_ZF_4LightBG.png" />
        </p>
 
        <p>
            Helpful Links: <br />
            <a href="http://framework.zend.com/">Zend Framework Website</a> |
            <a href="http://framework.zend.com/manual/en/">Zend Framework
                Manual</a>
        </p>
    </div>
</div>

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

<!-- application/views/scripts/error/error.phtml -->
    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN";
        "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd>
    <html xmlns="http://www.w3.org/1999/xhtml">
    <head>
      <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
      <title>Zend Framework Default Application</title>
    </head>
    <body>
      <h1>An error occurred</h1>
      <h2><?php echo $this->message ?></h2>
     
      <?php if ('development' == $this->env): ?>
     
      <h3>Exception information:</h3>
      <p>
          <b>Message:</b> <?php echo $this->exception->getMessage() ?>
      </p>
     
      <h3>Stack trace:</h3>
      <pre><?php echo $this->exception->getTraceAsString() ?>
      </pre>
     
      <h3>Request Parameters:</h3>
      <pre><?php echo var_export($this->request->getParams(), 1) ?>
      </pre>
      <?php endif ?>
     
    </body>
    </html>

创建一个虚拟主机

为了学习这个快速入门,我们假设您正在使用 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 常量的值。在实际生产中,您可以取消这个指令(在这种情况下,APPLICATION_ENV 的默认值将是 production)或者把它精确的设置为 production。

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

127.0.0.1 quickstart.local

启动 web 服务器(或者重启),现在应该准备就绪了。

译者注:实际上还有一个重要的文件:quickstart/public/.htaccess,这个文件看起来是这样的:

 

SetEnv APPLICATION_ENV development

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

检查

在此时,应该可以启动 Zend Framework 应用程序了。把浏览器指向服务器的名字(本例中就是:http://quickstart.local);应该能看到一个欢迎页面。

ImageHost.org

  • 0
    点赞
  • 4
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值