【PHP】Zend Framework 2 安装

转自：http://my.oschina.net/ohcoding/blog/145418

Apache：

    1、打开 mod_rewrite 支持

        （1）打开 httpd.conf 文件

        （2）找到 #LoadModule rewrite_module modules/mod_rewrite.so 这一行

        （3）把这行左侧第一个字符（#）删除

        （4）保存修改后的 httpd.conf 文件并重启 Apache

    2、支持 .htaccess 文件

        要支持 .htaccess 文件有两种方法

        下面的操作假设 ZF2 开发项目保存在 e:\Web\zf2working\ 目录下

        方法一：直接修改 httpd.conf 文件

            （1）、打开 httpd.conf 文件

            （2）、找到 zf2working"> 段，如果没有可以全新手动添加

            （3）、添加 AllowOverride All 或者将原有的 AllowOverride None 修改成 AllowOverride All

            （4）、保存修改后的 httpd.conf 文件并重启 Apache

        方法二：在 httpd-vhosts.conf 文件中修改

            （1）打开 httpd-vhosts.conf 文件，该文件一般在“Apache安装路径/conf/extra/”目录下

            （2）在文件底部手动添加以下信息

                
                    DocumentRoot "E:/Web/ZF2Working/zf2-tutorial/public"
                    ServerName zf2-tutorial.localhost
                    # This should be omitted in the production environment
                    SetEnv APPLICATION_ENV development
                    
                        DirectoryIndex index.php
                        AllowOverride All
                        Order allow,deny
                        Allow from all
                    
                

            以上代码详细说明将在后面ZF2环境配置中详细介绍，这里只要注意加粗部分就可以了。

            （3）保存修改后的 httpd-vhosts.conf 文件并重启 Apache

PHP：

    1、版本要在 5.3.x 以上（包含 5.3.x）

    由于 ZF2 采用了 PHP5.3+ 中很多的特性和函数，例如：namespaces, late static binding, lambda functions and closures 所以要求 PHP 版本必须为 5.3 以上（含 5.3）

    2、打开 openssl 支持（可选）

    这个要说一下，在接下来的安装过程中会介绍两种安装方式：（1）在线安装；（2）手动安装，如果采用“在线安装”那么 openssl 需要打开，不然安装会失败，如果是“手动安装”openssl 开不开就无所谓了。

        （1）打开 php.ini 文件

        （2）找到 ;extension=php_openssl.dll这一行

        （3）将这行左侧第一个字符（;）去掉

        （4）保存修改过的 php.ini 文件并重启 Apache

    3、打开 PDO MySQL 数据库支持（可选）

    PHP默认是打开了 Sqlite 支持的，如果需要使用到 MySQL 就需要打开 PDO 的 MySQL 数据库支持

        （1）打开 php.ini 文件

        （2）找到 ;extension=php_pdo_mysql.dll这一行

        （3）将这行左侧第一个字符（;）去掉

        （4）保存修改过的 php.ini 文件并重启 Apache

MySQL：

    没有特别需求，如果项目不牵涉到数据库，MySQL 甚至可以不装。也可以根据项目要求使用其它的数据库，例如：Sqlite 等。

三、安装Zend Framework 2

做完以上环境设置以后，本篇中最重要的部分来了！

ZF2 有两种安装方式：一种是“在线安装”另一种是“手动安装”。

1、在线安装

所谓的“在线安装”就是使用托管在 github 上的 ZendSkeletonApplication （Skeleton在字典里解释为：骨架，骨骼。所以可以叫做“Zend应用程序骨架”或者可以理解为“Zend应用程序模板”）来构建我们自己的应用程序。

（1）在浏览器中打开 https://github.com/zendframework/ZendSkeletonApplication

（2）点击图片右下角的 zip 按钮（上图画红圈的按钮），下载 ZendSkeletonApplication，下载的文件名类似 ZendSkeletonApplication-master.zip。这就是我们构建自己应用程序的基础，也可以理解成我们应用程序的一个初始化的空白模板。

（3）将下载的压缩包解压，产生 ZendSkeletonApplication-master 文件夹。

（4）将 ZendSkeletonApplication-master 文件夹复制到 e:\Web\zf2working\ 目录下，形成 e:\Web\zf2working\ZendSkeletonApplication-master\ 的结构。e:\Web\zf2working\ 是我在学习ZF2时定义的一个目录，您可以根据项目的要求或自己的喜好修改目录，但这个目录必须可以被 Apache 访问到。

（5）将 ZendSkeletonApplication-master 文件夹更名为您的项目名称，在这里我将 ZendSkeletonApplication-master 文件夹更名为：zf2-tutorial，既把 e:\Web\zf2working\ZendSkeletonApplication-master\ 修改为 e:\Web\zf2working\zf2-tutorial\。最终我的目录结构如下图所示

有关虚拟主机的设置见下一个小节

（6）在 zf2-tutorial 目录下有一个文件叫 composer.phar 这就是在线安装的主要执行文件。打开dos窗口，切换到 zf2-tutorial 目录执行 php composer.phar self-update 命令，执行结果如下图

注意：由于要使用到 PHP 的命令行，所以要将 php.exe 文件路径添加到系统的 PATH 里面，不然会报找不到 php.exe 错误

（7）当命令执行完成后接下来就是在线安装 ZF2 了，在 zf2-tutorial 目录下执行 php composer.phar install 命令，执行结果如下图

上图中有关“git”和"hg"报错的信息没有什么关系，不会影响到 ZF2 的安装。

至此 ZF2 的“在线安装”全部结束。下面有几点做一个说明

（1）“在线安装”过程所花时间的长短取决于您当地的网络情况；

（2）ZendSkeletonApplication、composer 和 Zend Framework 2 这三者之间是什么关系？ZendSkeletonApplication 是 Zend 应用程序骨架（或者是 Zend 应用程序模板），ZendSkeletonApplication 通过 composer 来解决依赖性的问题，而 ZendSkeletonApplication 所依赖的是 Zend Framework 2。

（3）php composer.phar self-update 这个命令干了什么？该命令主要是检测 ZendSkeletonApplication 最新依赖性的检测和升级

（4）php composer.phar install 这个命令干了什么？该命令装了 Zend Framework 2。这个命令在项目目录下的 vendor 目录下安装了ZF2的库文件和一些辅助文件，同时在项目目录下添加了一个 composer.lock 文件。

（5）php composer.phar install 报错 “The process timed out.”怎么办？如果你得到以下结果

1	[RuntimeException]

2	The process timed out.

说明您的网速不给力，需要用以下命令

1	COMPOSER_PROCESS_TIMEOUT=5000 php composer.phar install

2、手动安装

“手动安装”和“在线安装”只是在最后一步不同，“手动安装”的最后一步不是用命令行方式下载 ZF2，而是需要你手动将ZF2库添加到 ZendSkeletonApplication 目录中。

“手动安装”的前5步同“在线安装”的前5步

（6）下载ZF2，浏览器打开http://framework.zend.com/downloads/latest 选择 Zend Framework 2.2.1 Minimal 

（7）解压 ZendFramework-minimal-2.2.1.zip 文件到项目目录里的 vendor 子目录下的 ZF2 子目录下。

至此 ZF2 的“手动安装”全部结束。

四、虚拟主机的设定与配置

这个虚拟主机是否需要配置看个人开发的习惯，一般来说有个虚拟主机相对来说开发比较方便。官方教程上是建立了一个 zf2-tutorial.localhost 的虚拟主机，那我们也设定一个虚拟主机。

由于 ZF2 框架有一个唯一入口的脚本来接受外网的访问请求，既 public/index.php。在我的例子中就是：e:\Web\zf2working\zf2-tutorial\public\index.php，所以我要将 e:\Web\zf2working\zf2-tutorial\public\ 作为虚拟主机的目录

（1）打开 httpd-vhosts.conf 文件，该文件一般在“Apache安装路径/conf/extra/”目录下

（2）在文件底部添加以下代码

01

02	DocumentRoot "E:/Web/zf2Working/zf2-tutorial/public"

03	ServerName zf2-tutorial.localhost

04	# This should be omitted in the production environment

05	SetEnv APPLICATION_ENV development

06	"E:/Web/ZF2Working/zf2-tutorial/public">

07	DirectoryIndex index.php

08	AllowOverride All

09	Order allow,deny

10	Allow from all

11

12

（3）保存 httpd-vhosts.conf 文件

（4）打开 hosts 文件，该文件路径：C:\Windows\System32\drivers\etc

添加以下代码至文件底部

1	127.0.0.1 zf2-tutorial.localhost

保存并退出 hosts 文件

（5）重启 Apache

好了，ZF2 的所有安装和配置全部结束，看看自己的成果吧

在浏览器中输入 zf2-tutorial.localhost，如果可以看到以下页面，恭喜你！成功了，哇哈哈哈

五、测试 .htaccess 文件

在浏览器中输入 http://zf2-tutorial.localhost/1234 由于 1234 这个文件不存在，如果您的 .htaccess 文件的设定是有效的话，应该可以看到如下的显示

如果您看到的是类似下图显示的标准 Apache 404 错误。

那么您在继续教程之前必须修改 .htaccess 文件。如果您使用的是 IIS + Rewrite 模式，按如下修改 .htaccess 文件

1	RewriteCond %{REQUEST_FILENAME} !-f

2	RewriteRule ^.*$ index.php [NC,L]