编辑“EZ Publish/EZ Publish手动安装”

{{EZ Publish top}}
'''手动安装'''

这种安装方法只适用于高级用户，因为它的技术要求极强，初次接触者建议还是使用“[[EZ Publish/EZ Publish正常安装|EZ Publish正常安装]]”来进行安装。 手动安装需要一个已经安装了WEB 服务器，数据库等必须软件的系统。需要下载并解压eZ Publish。与安装向导不同，所有的配置均通过系统的命令行完成。

== 系统需求 ==

eZ Publish 需要五个软件系统：

web 服务器

# 服务器端PHP 脚本引擎
#eZ Components 库
#数据库
# 图像处理系统（可选）

前四个系统在安装eZ Publish 之前就必须已经存在。图像处理系统是可选的并且只有在需要eZ Publish
动态处理图像时才需要。web 服务器与[[PHP]] 引擎必须运行在同一台服务器。数据库可以运行于不同的服
务器。目前，可以使用以下软件解决方案：

'''web 服务器'''

目前，只支持[[Apache]] 服务器。在[[Linux]]/[[UNIX]] 系统，推荐使用最新的2.x 版本，但是Apache 必须运行
于"prefock"模式，而不是"threaded"模式。因为某些PHP 库或扩展不是[[线程]]安全的。

在[[windows]] 平台，建议使用最新的1.3 版本。（Apache2.x 在Windows 平台只支持"threaded"模式）
Apache 是一款自由，[[开源]]的[[软件]]，它是最广泛使用的web 服务器。可以从[http://www.apache.org 阿帕奇官网] 下载。

*服务器端的PHP 脚本引擎

eZ Publish 主要使用PHP 脚本语言，PHP（hypertext preprocessor）服务器端引擎是必须的。确保已安装
PHP5.1.6 以上版本。建议使用最新的5.x 版本，因为eZ Publish 在更新的PHP 版本上运行得更快，
而且某些扩展（如：eZ Flow）需要PHP5.2 以上的版本。确保您的PHP 版本符合所有软件模块的需求。
PHP 是自由软件。可以从[http://www.php.net PHP官网] 下载。

下表列出了需要编译的PHP 模块。
<table width="541" height="241" border="1" align="center">
  <tr>
    <td width="218" style="font-size:24px" align="center">模块名称</td>
    <td width="363" style="font-size:24px" align="center">简介</td>
  </tr>
  <tr>
    <td>MySQLi（建议使用）或MySQL</td>
    <td>需要，如果使用MySQL 数据库</td>
  </tr>
  <tr>
    <td>PostgreSQL</td>
    <td>需要，如果您使用PostgreSQL 数据库</td>
  </tr>
  <tr>
    <td>Zlib</td>
    <td>需要</td>
  </tr>
  <tr>
    <td>DOM</td>
    <td>需要</td>
  </tr>
  <tr>
    <td>Session</td>
    <td>需要</td>
  </tr>
  <tr>
    <td>PCRE</td>
    <td>需要</td>
  </tr>
  <tr>
    <td>GD2</td>
    <td>需要，如果ImageMagick 没有安装</td>
  </tr>
  <tr>
    <td>CLI</td>
    <td>建议</td>
  </tr>
  <tr>
    <td>CURL</td>
    <td>建议</td>
  </tr>
  <tr>
    <td>mbstring</td>
    <td>建议</td>
  </tr>
  <tr>
    <td>Exif</td>
    <td>建议</td>
  </tr>
</table>

*[[Zlib]]

确保PHP 支持zlib，否则安装向导无法解压下载的软件包。

*[[DOM]]

大多数情况下，PHP 支持DOM，因为PHP 内核已经包含了对DOM的支持。但是，某些Linux 发行版本的PHP 没有预编译对DOM的支持，需要安装一个称为"php-xml"的RPM包。这个RPM包会安装一个
共享模块来支持DOM。

*PHP CLI

建议安装PHP CLI，否则您将无法使用某些系统特性如：通知，延迟的检索索引，升级脚本，协作系统，从命令行清除[[缓存]]，等等。

*[[CURL]]

建议支持CURL，否则将无法使用某些系统特性如：通过[[代理服务器]]连接，eZSoap 的[[SSL]] 支持。

*PHP [[内存]]限制

eZ Publish 的安装向导至少需要64MB 的内存。如果使用的是PHP5.2.0 或更早的版本，需要在"php.ini"中增加"memory_limit"的值。（修改之后，需要重启Apache 服务器）

然而，建议保留64MB 或更高的内存限制，因为eZ Publish 在运信某些任务（如：重建索引，执行升级脚本等）时会消耗很多内存。另外，多语言的站点也需要至少64MB 内存。

如果使用的是PHP5.2.1 或更新的版本，不需要修改"memory_limit"（系统默认值为128MB）。

*PHP 时区

需要在"php.ini"中设置"date.timezone"。如果不指定时区，在用PHP5 运行eZ Publish 时，很有可能收到“依赖系统时区并不安全”之类的错误。PHP 时区配置示例：

  date.timezone = Asia/Shanghai

参考<nowiki>http://www.php.net/timezones</nowiki> 了解所有支持的时区代码。修改后，需要重启Apache 服务器。

*eZ Components 库

eZ Publish 是一个[[面向对象]]的[[应用程序]]。每一个类的定义保存在一个独立的[[PHP]] [[源文件]]中。eZ Publish 4用__autoload()来装载所需要的类。eZ Publish 安装之后，所有eZ Publish 内核类文件的路径都被包含在"autoload/ezp_kernel.php"中。除此以外，"autoload/ezp_extension.php"将用来保留扩展中类定义文件的路径。这些路径很可能需要被修改（例如：如果安装了一个新的扩展或通过后台“设置－扩展”来配置现有的扩展）。需要安装 eZ Components 2007.1.1 或更高版本来支持对autoload path 的更新。特别需要注意的是，至少需要安装File 和Base 组件("ezcBase"与"ezcFile")，否则eZ Publish 无法更新autoload path。

eZ Components 是一套基于PHP 的企业级通用组件库，它可以单独或与其他库共同用于PHP 应用程序的开发。可以从<nowiki>http://ezcomponents.org/download</nowiki> 下载。将来，eZ Components 将与eZ Publish 绑定。参阅<nowiki>http://ezcomponents.org/docs/install</nowiki> 了解如何安装eZ Components。

'''数据库'''

*eZ Publish 用数据库保存多种数据结构与数据。这意味着您的数据库必须一直可用。eZ Publish 默认支持
以下数据库：

#[[MySQL]]4.1 以上版本，5.x（推荐）
#PostgreSQL7.3 以上版本

*如果数据库与安装向导运行于同一台服务器，安装向导会自动检测数据库类型。eZ Publish 4 需要使用UTF-8 数据库。

*eZ Publish 4 不支持基于PostgreSQL 的集群。集群代码针对使用InnoDB 存储引擎的MySQL 数据库性能做过专门的优化。

*如果不需要在集群环境运行eZ Publish，虽然[[InnoDB]] 不是必须的，但是仍推荐使用。

*InnoDB 支持事务，因此可以在MySQL 数据库中使用事务安全型表（eZ Publish 默认支持数据库事务。这一特性能保证数据库的完整性不会被错误或异常中断的处理破坏）。

*如果希望使用PostgreSQL，确保"pgcrypto"模块已经安装。在Linux/UNIX 平台中，可能需要安装一个单独的软件包－"postgresql-contrib"，"pgcrypto"模块提供了用于PostgreSQL 的加密函数，包括"digest"，后者是eZ Publish 需要的。在为eZ Publish 配置PostgreSQL 数据库的时候，需要在数据库中注册这些函数。

'''[[Oracle]]'''

eZ Publish Oracle® 扩展1.8 版本（<nowiki>http://ez.no/doc/extensions/database</nowiki>）将在eZ Publish 4.0.1 以上版本中支持Oracle 数据库。注意：之前的版本不能用于eZ Publish 4。

为了缩放，变换或修改图片，eZ Publish 需要调用图像处理系统。可以选择使用以下系统中的一种（均为自由软件）：

#GD2 (由PHP 提供）
# ImageMagick (<nowiki>http://www.imagemagick.org</nowiki>)

== Linux/UNIX 安装 ==

确保系统满足手动安装的系统需求。确保系统运行于[[Linux]]/[[UNIX]]，并且已经安装[[Apache]]，[[PHP]]，[[MySQL]] 或[[PostgreSQL]]。如前所述，数据库可与[[WEB]] [[服务器]]运行于不同服务器。手动安装需要以下几个步骤：

#配置数据库（MySQL 或PostgreSQL）
#下载eZ Publish
# 解缩eZ Publish
#手动配置eZ Publish

手动安装与正常安装的不同只在于最后一步。手动安装通过手动配置若干文件来配置eZ Publish，而不启动安装向导。不同之处在手动配置一节中描述。

==Windows 安装==
确保系统满足手动安装的系统需求。确保系统运行于[[Windows]]，并且已经安装Apache，PHP，MySQL 或PostgreSQL。如前所述，数据库可与WEB 服务器运行于不同服务器。

手动安装需要以下几个步骤：

#配置数据库（MySQL 或PostgreSQL）
#下载eZ Publish
#解缩eZ Publish
#手动配置eZ Publish

手动安装与正常安装的不同只在于最后一步。手动安装通过手动配置若干文件来配置eZ Publish，而不启动安装向导。不同之处在手动配置一节中描述。

== 手动配置 ==
以下步骤适用于Linux/UNIX 与Windows。

1、初始化数据库

2、可以通过导入两个重要的SQL 脚本（"kernel_schema"和"cleandata"）来初始化eZ Publish 数据库。

<font color="red">注意：运行这两个脚本之前，需要创建一个空数据库</font>

3、第一个脚本创建必要的数据库结构，第二个脚本导入预定义的数据。

4、使用哪一个"kernel_schema"脚本取决于使用的数据库。"cleandata"脚本适用于 MySQL与PostgreSQL 数据库。

'''MySQL'''

用以下命令行执行MySQL 的"kernel_schema"脚本：

<pre>$ mysql -u USERNAME -pPASSWORD DATABASE < PATH/kernel/sql/mysql/kernel_schema.sql</pre>

这个脚本将使用InnoDB 存储引擎创建数据表。确保数据库的默认存储引擎也被设置为InnoDB，否则将来的系统升级将会造成混合的表类型。

使用以下脚本运行通用的"cleandata“脚本：

<pre>$ mysql -u USERNAME -pPASSWORD DATABASE < PATH/kernel/sql/common/cleandata.sql</pre>

<table width="309" height="117" border="1" align="center">
  <tr>
    <td width="97">USERNAME</td>
    <td width="196">MySQL 用户名</td>
  </tr>
  <tr>
    <td>PASSWORD</td>
    <td>MySQL 密码</td>
  </tr>
  <tr>
    <td>DATABASE</td>
    <td>数据库名</td>
  </tr>
  <tr>
    <td>PATH</td>
    <td><p>eZ Publish 的安装的绝对路径 例：/opt/ezp</p>
    </td>
  </tr>
</table>

'''文件权限'''

Windows 用户可以跳过这一步。如果eZ Publish 安装于Linux/UNIX 系统，某些文件的权限需要重新设置。

可以使用eZ Publish 自带的脚本来设置文件权限。这个脚本必须被执行，否则eZ Publish 无法正常运行。

这个脚本需要在eZ Publish 的安装目录中运行。
<pre>
$ cd /opt/ezp
$ bin/modfix.sh
</pre>

把"/opt/ezp"替换为您eZ Publish 安装目录的绝对路径。

"modifx"脚本递归地修改eZ Publish 安装目录中以下目录的权限：
<pre>
 var/*
 settings/*
 design/*
</pre>

如果知道WEB 服务器的用户与用户组，建议使用以下的权限：
<pew>
# chown -R user.usergroup var/
# chmod -R 770 var/
</pre>

"user.usergroup"必须被替换为WEB 服务器的用户与用户组。

'''配置eZ Publish'''

eZ Publish 目录中的"settings/override/site.ini.append.php"必须被修改，否则eZ Publish 不能正常运行。这个文件是site.ini 文件的一个全局的重设文件。这个文件中有很多选项需要配置（数据库，邮件发送系统，var 目录等等）。以下是一个通用的site.ini.append.php 示例：

<pre>
<?php /* #?ini charset="iso-8859-1"?
[DatabaseSettings]
DatabaseImplementation=ezmysql
Server=localhost
User=root
Password=Database=my_database
[FileSettings]
VarDir=var/example
[Session]
SessionNameHandler=custom
[SiteSettings]
DefaultAccess=example
SiteList[]
SiteList[]=example
[SiteAccessSettings]
CheckValidity=false
AvailableSiteAccessList[]
AvailableSiteAccessList[]=example
AvailableSiteAccessList[]=example_admin
RelatedSiteAccessList[]
RelatedSiteAccessList[]=example
RelatedSiteAccessList[]=example_admin
MatchOrder=host;uri
# Host matching
HostMatchMapItems[]=www.example.com;example
HostMatchMapItems[]=admin.example.com;example_admin
[InformationCollectionSettings]
EmailReceiver=webmaster@example.com
[MailSettings]
Transport=sendmail
AdminEmail=webmaster@example.com
EmailSender=test@example.com
[RegionalSettings]
Locale=eng-GBContentObject
Locale=eng-GBText
Translation=disabled
*/ ?>
</pre>

在上例中，"[SiteAccessSettings]"章节中的"AvailableSiteAccessList[]"数组定义了两个可用的站点入口："example" 和"example_admin"。"CheckValidity"应设置为false，否则访问这个站点时安装向导会被触发。

除此以外，还需创建两个站点入口的配置文件。一个公共站点入口（"example"），一个管理站点入口（"examle_admin"）。在eZ Publish 根目录下创建以下站点入口目录：

• settings/siteaccess/example

• settings/siteaccess/example_admin

两个站点入口都需要一个独立的"site.ini.append.php"文件。

'''公共站点入口'''
<pre>
<?php /* #?ini charset="iso-8859-1"?
[SiteSettings]
SiteName=Example
SiteURL=www.example.com
LoginPage=embedded
[SiteAccessSettings]
RequireUserLogin=false
ShowHiddenNodes=false
[DesignSettings]
SiteDesign=example
[ContentSettings]
ViewCaching=disabled
[TemplateSettings]
TemplateCache=disabled
TemplateCompile=disabled
#ShowXHTMLCode=enabled
#Debug=enabled
[DebugSettings]
DebugOutput=enabled
Debug=inline
#DebugRedirection=enabled
[RegionalSettings]
SiteLanguageList[]
SiteLanguageList[]=eng-GB
ShowUntranslatedObjects=disabled
*/ ?>
</pre>

'''管理站点入口'''
<pre>
<?php /* #?ini charset="iso-8859-1"?
[SiteSettings]
SiteName=Example
SiteURL=admin.example.com
LoginPage=custom
[SiteAccessSettings]
RequireUserLogin=true
ShowHiddenNodes=true
[DesignSettings]
SiteDesign=admin
[ContentSettings]
CachedViewPreferences[full]=admin_navigation_content=0;admin_navigation_details=0;admin_navi
gation_languages=0;admin_navigation_locations=
0;admin_navigation_relations=0;admin_navigation_roles=0;admin_navigation_policies=0;admin_na
vigation_content=0;admin_navigation_translatio
ns=0;admin_children_viewmode=list;admin_list_limit=1;admin_edit_show_locations=0;admin_url_l
ist_limit=10;admin_url_view_limit=10;admin_sec
tion_list_limit=1;admin_orderlist_sortfield=user_name;admin_orderlist_sortorder=desc;admin_s
earch_stats_limit=1;admin_treemenu=1;admin_boo kmarkmenu=1;admin_left_menu_width=13
[DebugSettings]
DebugOutput=disabled
Debug=inline
[RegionalSettings]
SiteLanguageList[]
SiteLanguageList[]=eng-GB
ShowUntranslatedObjects=enabled
*/ ?>
</pre>
<font color="red">
注意：
在"settings/override/site.ini.append.php"中定义的数据库配置，邮件配置，区域配置与其它配置适用于所
有的站点入口。在本例中，"Database=my_database"在这个文件中的"[DatabaseSettings]“定义，因
此"example"与"example_admin"均会使用这个数据库。参阅“基本概念”中的“站点管理”与“配置”
两个章节了解更多内容。
</font>

'''Unicode 支持'''

不需要重设"i18n.ini"文件，因为eZ Publish 4 默认启用对[[unicode]] 的支持。

'''语言'''

可用语言与优先级可以通过修改每个站点入口中的"site.ini.append.php"中的"[RegionalSettings]"章节中
的"SiteLanguageList"配置来定义。如果不指定，系统会使用旧的"ContentObjectLocale“配置，因此只有默
认语言会被显示。参阅“配置站点语言”章节了解更多内容。

"cleandata.sql"脚本只创建一种英式英文（eng-GB）一种语言。 其它语言需要通过管理界面的“设置－
语言”来添加(在本例中：<nowiki>http://admin.example.com</nowiki>)。

'''动态树状菜单'''

如果站点有很多节点，建议为管理站点入口启用"Dynamic"选项。这会使管理界面左侧的树状
菜单速度更快并减少对[[网络]][[带宽]]的消耗。

'''系统管理员的登录名与密码'''

"cleandata.sql"会创建以下的管理员登录名与密码。

登录名： admin

密码：publish

建议立即修改管理员的密码。

<font color="red">
注意：
如果需要另外的管理员帐号，可以创建新的管理员帐号；用新帐号登录管理界面；
删除旧管理员帐号。
</font>

==参考来源==
*http://wenku.baidu.com/view/8cf795b665ce05087632138a.html
*http://ez.no/eZPublish/New-Release

[[category:EZ Publish|E]]
{{EZ Publish}}