Tutorial.Introduction And Installation I.zh_cn
- 引言
Pi Engine是一个Web与移动应用快速开发平台。它的原名为Xoops Engine，从它原来的名字就可以看出，这个应用是在XOOPS的基础上发展起来的，也被称作为下一代的XOOPS。
因此，我们有必要先认识下什么是XOOPS？XOOPS是对eXtensible, Object, Oriented, Portal, System这几个单词的简写，这些单词的直译就是面向对象的可扩展门户系统，也就是一个强大的基于web的内容管理平台。XOOPS是一个开放源代码的工具程序，用于实现从小型到大型的动态交互社区，公司门户，企业内部网，网络日志等。安装到服务器主机后，网站管理员可以登陆到管理区，通过浏览器来管理内容信息。后台管理手段直观易用，不需要任何编程，而且XOOPS还提供了方便的安装程序。XOOPS是一个软件包，是一个网站群和一个遍布世界、非常友善的支持社区。而将这三者紧密联系在一起的是WEB-互联网的图形界面。
XOOPS项目组成立于2001年，到2003年升级到2.0版本后，中间经过近七年的时间升级到了XOOPS2.5。在Pi Engine之前XOOPS也发布了XOOPS3.0版本。由于中间停滞造成的开发人员的流失让XOOPS不得不面临两大问题：系统更新缓慢，并处于过期状态；很难赶上当前互联网的发展速度。正因为此，Pi Engine也应运而生。
- Pi Engine的特点
之前已经介绍过Pi Engine是从XOOPS发展而来，因此它也继承了XOOPS基本特点：面向对象、可扩展、直观易用。当然Pi Engine的出现也是为了弥补XOOPS的不足，因此Pi Engine给自己定义了新的特点：
-
适应大规模、高并发、分布式
-
工程化、规范化、快速开发、连续集成
-
开放性、可扩展性
-
对第三方开发者友好的架构
-
面向对象并严格支持PHP5.3
-
完全M-V-C架构和语义化模板
-
模块化设计和多模板机制
-
基于角色和群组和权限控制
-
可扩展的URL重写和SEO支持
- 对于开发者和用户，Pi能做什么
对于开发者，Pi Engine力争实现一个通用的开发平台，它希望大部分开发者通过对代码的扩展，可以实现自己的需要，根据现Pi Engine的功能，这里对Pi Engine完成基本互联网开发外，所提供的可扩展功能做了如下的概括：
- 自定义导航
- 模块+区块自定义布局
- 自定义路由
- 权限控制
- 本地化
通过上面的基本介绍，大家应该对Pi Engine的概念有一个直观的了解，在后面的章节里，本教程将会以开发者的角度更详细、更系统地介绍Pi Engine，让开发者能够更快地学会使用Pi Engine。
- 安装Pi Engine
4.1 环境配置
Pi Engine的安装需要一些必要的软件以及环境配置，下面列出了一些基本的软件及其版本：
- Apache 2.2+
- PHP 5.3+
- MySQL
这里的‘+’表示所写版本及以上的意思。如果环境是要Win下运行，建议安装集成软件包WAMP，即Win+Apache+MySQL+PHP。下面也主要以WAMP为例，下载地址为：
选择5.3或者5.4版本，之后我们会用到apc扩展，由于目前没有支持64位的apc扩展，因此WAMP需要选择32位版。
Pi安装时要求开启APC（php_apc.dll）扩展以及rewrite_module选项，因此在安装完WAMP后，需要添加相应的扩展，php_apc.dll的下载地址为：
http://downloads.php.net/pierre/
所选择的版本应该与WAMP里的Compiler, Thread Safety以及PHP版本均一致的扩展包，例如，查看phpinfo的第一项内容，看到Compiler为MSVC9，PHP版本为5.3.13，因些需要下载php_apc-3.1.10-5.3-vc9-x86.zip文件，而Thread Safety项为enable，因此将解压后的ts文件夹下的apc文件拷到wamp安装目录下的bin\php\php5.3.13\ext文件夹下，之后需要退出wampServer，重新启动wampServer后在PHP extension里就可以看到apc项，最后在wampServer里将apc扩展打勾即可（WAMP会自动重启）。
图1-1 APC配置
如果当前的操作系统为WinXP，则需要相应的APC扩展，下载地址为：
http://belsky.info/uploads/my/bugz/61984/php_apc-3.1.10-5.3-vc9-x86-xp.zip
之后还需要勾选rewrite_module选项。
图1-2 配置rewrite_module
这样，Pi Engine在Windows上所需要的基本环境就搭建完成了。
4.2 源码获取
Pi Engine的源码可以通过svn从github上下载，也可以直接到github上下载。
使用SVN获取源码需要先安装SVN相关软件，这里我们使用Subversion软件，下载地址为：
http://subversion.apache.org/download/#supported-releases
安装完Subversion软件后，点击右键就可以看到SVN的相关操作选项，现在就可以从SVN上下载Pi Engine源码了。
进入WAMP的安装目录后，进入www文件夹下，点击右键，在出现的菜单项里选择“Check out...”选项，在弹出的对话框里的Repository url表单里填入以下地址：
https://github.com/pi-engine/pi/
点击确定后，源码会下载下指定目录下。需要注意的是，实际的源码是在下载目录的trunk子目录里。
而github上下载源码则更简单了，登陆https://github.com/pi-engine/pi/ ， 然后点击页面的zip按钮，下载完后将文件解压，然后放在WAMP的安装目录的www文件夹下即可。
至此，运行环境和源码都已经准备好了，接下来就是安装Pi Engine了。
4.3 安装Pi
到现在就应该可能安装Pi了，不过先别着急，我们还需要先配置好数据库，以便系统将默认数据表及数据写入数据库。
在MySQL里创建一个数据库，名字可任意，但别忘了将数据库的字符编码集设为UTF8。同时还需要设置数据库的权限。具体的权限设置方法可参考：http://www.leapsoul.cn/?p=916
现在就可以开始体验Pi Engine为用户准备的类似Wordpress的五分钟快速安装。假设目前您用的是本地环境，也没有设置虚拟主机，即访问服务器的根目录只需在浏览器的地址栏键入localhost。您就可以通过访问下面的url开始安装：localhost/{Pi Engine package name}/www/setup。整个安装过程只需要配置四个地方：
图1-3 安装语言环境
第一步为基本配置，Language Selection主要配置系统的语言，之后访问页面时，系统会自动将英文转换成您所选择的语言。而Server setting detection列出环境配置是否正确，确认后面有一个绿色的对勾，就可以进入下一项了。
图1-4 配置路径
第二步为配置系统会用到的一些路径以及想要为系统使用的缓存机制。
图1-5 采用配置静态目录的二级域名
在Advanced settings列表中，asset, upload和static目录可以用二级域名的形式，如果这样指定，将需要将Pi Engine的www目录下相应的文件夹放到二级域的根目录下。
而Persistent data container里可以根据自己的情况选择相应的缓存机制。
图1-6 配置数据库
第三步也就是数据库配置，正确配置数据库信息后，系统将会把默认的数据都写进这个数据库里。其中Database name就是我们在安装之前所创建的数据库名称，而Table prefix可以选择生成的随机数，也可以手动填写。加表前缀主要是出于安全因素。
图1-7 配置帐号
第四步，也就是最后一步，主要配置Pi Engine的超级管理员帐号，这个帐号将具有所有权限。点击Next后，如果安装成功将会出现以下页面：
图1-8 安装成功
安装成功之后，就可能开始访问Pi Engine系统了，访问localhost/{Pi Engine package name}/www，就可以登陆前台页面，在首页登陆后，就可以看到导航栏里多了一个Admin Area菜单，这就是后台的入口。