菜菜鸟Zend Framework 2 不完全学习涂鸦（一）-- 安装配置
声明：本人 PHPer 菜鸟一枚，Zend Framework 2 框架的菜菜鸟，刚学习 ZF2 不过 2 天。由于英语实在太破，所以一开始只能找网上 ZF2 中文教程，但很多教程都只说到 ZF2 安装与配置就结束了，没有了下文。看来只能硬着头皮拿着字典一点点去看官方教程了，以下是我做的一些学习涂鸦，学习过程还是按照官方教程的顺序。才疏学浅，望大侠多多指教......谢谢。
---------------------------------------------------------------------------------------------------
说明：
（1）ZF2 并不向下兼容 ZF1。所以 ZF1 开发的项目无法在 ZF2 中运行。
（2）我所使用的开发环境 Win7 + Xampp v.1.8.1，包含：Apache 2.4.3，PHP 5.4.7，MySQL 5.5.27
（3）DocumentRoot：e:\Web
（4）e:\Web\zf2working\ 是我建立的一个学习ZF2的目录，目的是与我其它的项目区分开
（5）Zend Framework 2.2.1
一、Zend Framework是什么？
这个不多说了，Google 和 Baidu 一大推。
官方的说明：http://framework.zend.com/about/
简要总结：
1、PHP Web 应用程序框架；
2、完全面向对象（OOP）；
3、MVC（Model-View-Controller）开发模式；
4、使用 PHP5.3+ 新功能和函数；
5、松耦合组件；
6、强大的类库；
7、强大的技术支持（Zend Technologies，PHPer 们几乎没人不知道 Zend Technologies 吧。）；
二、Zend Framework 2 安装环境要求
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）、找到 <Directory "e:/Web/zf2working"> 段，如果没有可以全新手动添加
（3）、添加 AllowOverride All 或者将原有的 AllowOverride None 修改成 AllowOverride All
（4）、保存修改后的 httpd.conf 文件并重启 Apache
方法二：在 httpd-vhosts.conf 文件中修改
（1）打开 httpd-vhosts.conf 文件，该文件一般在“Apache安装路径/conf/extra/”目录下
（2）在文件底部手动添加以下信息
<VirtualHost *:80>
DocumentRoot "E:/Web/ZF2Working/zf2-tutorial/public"
ServerName zf2-tutorial.localhost
# This should be omitted in the production environment
SetEnv APPLICATION_ENV development
<Directory "E:/Web/ZF2Working/zf2-tutorial/public">
DirectoryIndex index.php
AllowOverride All
Order allow,deny
Allow from all
</Directory>
</VirtualHost>
以上代码详细说明将在后面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.”怎么办？如果你得到以下结果
[RuntimeException]
The process timed out.
说明您的网速不给力，需要用以下命令
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）在文件底部添加以下代码
<VirtualHost *:80>
DocumentRoot "E:/Web/zf2Working/zf2-tutorial/public"
ServerName zf2-tutorial.localhost
# This should be omitted in the production environment
SetEnv APPLICATION_ENV development
<Directory "E:/Web/ZF2Working/zf2-tutorial/public">
DirectoryIndex index.php
AllowOverride All
Order allow,deny
Allow from all
</Directory>
</VirtualHost>
（3）保存 httpd-vhosts.conf 文件
（4）打开 hosts 文件，该文件路径：C:\Windows\System32\drivers\etc
添加以下代码至文件底部
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 文件
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^.*$ index.php [NC,L]
六、错误报告配置（可选）
还记得上文中在设定虚拟主机时添加的代码么？
<VirtualHost *:80>
DocumentRoot "E:/Web/zf2Working/zf2-tutorial/public"
ServerName zf2-tutorial.localhost
# This should be omitted in the production environment
SetEnv APPLICATION_ENV development
<Directory "E:/Web/ZF2Working/zf2-tutorial/public">
DirectoryIndex index.php
AllowOverride All
Order allow,deny
Allow from all
</Directory>
</VirtualHost>
在代码中有一行
SetEnv APPLICATION_ENV development这行说明目前我们将整个项目的模式设定为”开发模式（developement）“，在这个模式下 PHP 会向浏览器输出所有的错误信息，方便我们的开发和调试。
注意：项目正式上线之前要将这个模式删除，以免造成信息泄露和安全漏洞。
除了在虚拟主机的配置文件中设定开发模式之外，还需要在项目入口文件中做一点额外的设定。
打开 e:\web\zf2working\zf2-tutorial\public\index.php ，默认的代码如下
<?php
/**
* This makes our life easier when dealing with paths. Everything is relative
* to the application root now.
*/
chdir(dirname(__DIR__));
// Decline static file requests back to the PHP built-in webserver
if (php_sapi_name() === 'cli-server' && is_file(__DIR__ . parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH))) {
return false;
}
// Setup autoloading
require 'init_autoloader.php';
// Run the application!
Zend\Mvc\Application::init(require 'config/application.config.php')->run();
在文件顶部添加以下代码
/**
* Display all errors when APPLICATION_ENV is development.
*/
if ($_SERVER['APPLICATION_ENV'] == 'development') {
error_reporting(E_ALL);
ini_set("display_errors", 1);
}
最终的代码如下：
<?php
/**
* Display all errors when APPLICATION_ENV is development.
*/
if ($_SERVER['APPLICATION_ENV'] == 'development') {
error_reporting(E_ALL);
ini_set("display_errors", 1);
}
/**
* This makes our life easier when dealing with paths. Everything is relative
* to the application root now.
*/
chdir(dirname(__DIR__));
// Decline static file requests back to the PHP built-in webserver
if (php_sapi_name() === 'cli-server' && is_file(__DIR__ . parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH))) {
return false;
}
// Setup autoloading
require 'init_autoloader.php';
// Run the application!
Zend\Mvc\Application::init(require 'config/application.config.php')->run();
未完待续......谢谢