Propel教程翻译：01-安装，01-Installation.txt

安装Propel

Propel可以下列方式获得 ： PEAR 包 、 “传统”的 tgz 或者 zip 包、从一个 Subversion 仓库下载。无论你选择使用哪种安装方式 ，要让 Propel 工作起来都很容易。

前提条件

Propel的依赖情况很简单，它可以在大部分PHP 平台上运行 ：

• •. PHP 5.2.4 或更新版 ，并且启用咯 DOM (libxml2) 模块

• •. 被 Propel所支持的一个数据库（ MySQL 、 MS SQL Server 、 PostgreSQL 、 SQLite 、 Oracle ）

提示 ： Propel使用咯PDO 和SPL 组件，它们默认是与PHP5 绑定在一起的 。

Propel组件

Propel库由 2个组件组成：一个生成器和一个运行时库 。这 2个组件不是互相依赖的，所以可以独立安装。

生成器是用来构建对象模型的 ，但是对于使用 Propel 的程序来说不是必需的 。

运行时类提供咯被那些由Propel 生成的对象模型类使用的公共的函数 。这对于使用 Propel 来访问数据库的程序来说是必需的 。

通常，在开发环境下 ，生成器和运行时组件都安装咯 ，但是实际的测试或者生产服务器只需要安装运行时组件 。至于你跟的第一次接触 ，尽管把2个都安装好咯。

安装Propel

从PEAR 安装 Propel

要想安装Propel 包 ，你必须将 `pear.propelorm.org` 频道添加到你的 PEAR 环境中。一旦发现咯这个频道，你就可以安装生成器包 、或者运行时包、或者2个都安装。使用 '-a' 选项来让 PEAR 下载并安装依赖项 。

#!sh

> pear channel-discover pear.propelorm.org

> pear install -a propel/propel_generator

> pear install -a propel/propel_runtime

现在Propel 安装好咯 ，你可以按照这个页面末尾的 测试Propel 的安装 小节里面的指示来测试它咯 。

提示 ：如果你想要安装一个非稳定版的 Propel ，那么就在安装 Propel 包之前修改 `preferred_state` 这个 PEAR 环境变量。有效的状态包括 'stable' 、 'beta' 、 'alpha' 、和 'devel' ：

#!sh

> pear config-set preferred_state beta

针对Tar软件包和Subversion 版本的依赖

Propel生成器使用 Phing 2.3.3 来管理命令行任务；生成器和运行时类都使用 PEAR Log 来记录事件。

如果你通过PEAR 来安装Propel ，那麽这些组件会被自动作为依赖项安装。如果你使用一个 tar 软件包或者从 Subversion 下载的源代码来安装 Propel ，那么你需要手动安装它们：

#!sh

> pear channel-discover pear.phing.info

> pear install phing/phing

> pear install Log

参见它们各自的网站以了解Phing 和Log 的其它安装方式。

安装来自Subversion 的Propel

安装来自SVN 主分支的源代码能够确保你拥有最新的版本 。

#!sh

> svn checkout http://svn.propelorm.org/branches/1.5 /usr/local/propel

这将会把生成器和运行时组件都导出到你本地的`propel`目录中 。另外，你还会获得 Propel 的文档和单元测试内容 -所以这是 Propel 的贡献者的首选安装方法 。

一旦做好咯这个 ，你就需要设置 PHP 环境以使用这个库 -参见下面的为Propel设置 PHP 小节 。

注意：`branches/1.5`在当前是比`trunk`更新的代码；主分支 （ trunk ） 将会成为2.0 版，然而很久以来其中的代码没有什么改变。

安装来自Tar软件包的 Propel

从Propel 网站下载Propel 各个组件的tar软件包 ，再将它们解压到最适合你自己的需求的地方 。例如，在 Linux 中 ：

#!sh

> cd /usr/local

> mkdir propel

> cd propel

> wget http://pear.propelorm.org/get/propel_generator-1.5.0.tgz

> tar zxvf propel_generator-1.5.0.tgz

> wget http://pear.propelorm.org/get/propel_runtime-1.5.0.tgz

> tar zxvf propel_runtime-1.5.0.tgz

一旦做好咯这个 ，你就需要设置 PHP 环境以使用这个库 。

为 Propel 生成器设置 PHP

只有你从tar软件包或者从Subversion 安装Propel 的时候 ，才需要进行下面的操作。

Propel生成器组件包含咯一个`propel-gen`sh 脚本 （在 Windows 上是 `propel-gen.bat` 脚本）。这个脚本简化咯在命令行调用 Propel 生成器的工作 ，因为它隐藏咯对 Phing 的调用 。

你可以在命令行直接调用它 ：

#!sh

> /usr/local/propel/generator/bin/propel-gen

为咯让这个脚本的执行更简单 ，你还可以：

• •. 将propel 生成器的`bin/`目录添加到你的PATH 中 ，

• •. 或者将`propel-gen`脚本复制到你的PA T H 中的某个位置 ，

• •. 或者 （在 Linux 系统中）创建一个符号链接。例如：

#!sh

> cd /usr/local/bin

> ln -s /usr/local/propel/generator/bin/propel-gen propel-gen

测试Propel 的安装

你可以通过在命令行界面 ( CLI ) 下调用`propel-gen`脚本来测试Propel生成器组件是否已经正确安装咯 :

#!sh

> propel-gen

这个脚本应当输出几行东西 ，再显示一个 'BUILD FAILED' 消息。这是正常的 -你还没有定义数据库模型勒 。

你可以通过包含`Propel.php`脚本来测试Propel 运行时组件是否已经正常安装 ：

#!php

<?php

// PEAR installation

require_once 'propel/Propel.php';

// manual installation

require_once '/usr/local/propel/runtime/lib/Propel.php';

// Propel setup code ... (to be discussed later)

到咯这个时候 ， Propel应当已经设置好咯 ，可以用咯。你可以按照维基页面 构建向导 （ Build Guide ） 中的步骤来试用它 。

排错

PHP配置

Propel需要在`php.ini`中的以下设置 ：

变量	值
ze1_compatibility_mode	Off
magic_quotes_gpc	Off
magic_quotes_sybase	Off

位于包含路径中的PEAR目录

如果你选择咯通过PEAR 来安装Propel ，并且这是你第一次使用 PEAR ，那么 PEAR 目录可能不在你的 PHP 的 ｀包含路径｀（ `include_path` ） 里 。参见 PEAR 文档以了解该怎么做 。

寻找帮助

如果你没法安装Propel ，那就马上找人帮忙吧 。参见维基页面 支持 （ Support ）以了解该如何找人帮忙。