eaccelerator readme for linux 简体中文翻译
eaccelerator 是一个为 php 程序加速的免费开源软件，其极速效果绝不输给 zend performance suite。并且支持 linux, freebsd, solaris, macos x, windows等系统。
今天闲来无事，将 readme for linux 文件翻译了出来，供大家参考。
其中安装部分进行了修改，细化了安装过程。
其中翻译不确切的地方还请大家指教：）
【翻译：nanu (nanu@discuz.com) 】
eaccelerator for php
什么是 eaccelerator ？
eaccelerator 是一个开源并且免费的 php 加速器，优化器，编码器，同时也能够为 php
提供动态内容缓存。它能够将 php 脚本缓存为已编译状态以达到提升 php 脚本运行性能
的目的，因此传统的预编译几乎被消除。eaccelerator 也能够优化 php 脚本以提升 php
脚本的执行速度。eaccelerator 可有效降低服务器负载并且提高 php 程序速度达 1-10 倍。
turckmmcache 是 eaccelerator 的前身。
( http://sourceforge.net/project/turckmm-cache/ by dmitry stogov )
eaccelerator 包含一个 php 编码器和加载器。您可以使用编码器对 .php 脚本进行编码，
从而能够以非源代码方式发布您的 php 程序。经过编码的 php 程序可以运行在任何安装有
php 解析环境和 eaccelerator 的站点上，由于编码后的 php 程序存储为已编译代码，并且
已编译版本中不包含程序的源代码，因此，经过 eaccelerator 编码的 php 程序是不能被还原
恢复的。当然，一些内部脚本可以被某些不同的反编译引擎工具（如 disassemblers, debuggers等）
进行还原恢复，但这并非是微不足道的。
eaccelerator 与 zend optimizer 加载器兼容。在 php.ini 中，zend optimizer 必须在
eaccelerator 之后加载。如果您的站点不运行任何经由 zend 编码器编码的 php 脚本，那么
我们并不推荐您在安装 eaccelerator 的服务器上安装 zend optimizer。
eaccelerator 不能运行于 cgi 模式下，但它可以运行于像 lighttpd 类似的 fast-cgi模式。
以下是一些与 eaccelerator 具有相同功能的产品：
- zend performance suite (http://www.zend.com)
- alternative php cache (http://pecl.php.net/package/apc)
下载
最新版的 eaccelerator 可以在 sourceforge 下载：
http://sourceforge.net/projects/eaccelerator/
cvs 开发版本快照(snapshots)可以在以下地址下载：
http://snapshots,eaccelerator.net
所需环境
apache 1.3 或更高版本
mod_php 4.1 或更高版本
autoconf
automake
libtool
m4
兼容性
经过用户的使用和报告，eaccelerator 能够运行在 php4 和 php5。php5.1 目前尚不能完整的
支持。eaccelerator 能够与 apache 1.3/2.0、lighttpd、和 iis 在 linux、freebsd、macos x、solaris 和
windows 上运行。
快速安装
您可以在 eaccelerator 站点获取更多有关安装方面的信息。
http://eaccelerator.sourceforge.net/
注意(1)：有关 microsoft windows 平台的安装信息，请阅读 readme.win32 file。
步骤 1. 编译 eaccelerator
cd /usr/local/src
wget http://internap.dl.sourceforge.n ... rator-0.9.4.tar.bz2
tar xjvf eaccelerator-0.9.4.tar.bz2
cd eaccelerator-0.9.4.tar.bz2
export php_prefix=/usr/local/php
$php_prefix/bin/phpize
./configure \
--enable-eaccelerator=shared \
--with-php-config=$php_prefix/bin/php-config
make
您必须在 export 命令中指定 php 真实的安装目录位置。该目录位置可能是 /usr /usr/local，或
其他位置。
步骤 2. 安装 eaccelerator
make install
步骤 3. 配置 eaccelerator
eaccelerator 可以安装为 zend 扩展或者 php 扩展。
对于 eaccelerator 0.9.1 及其以上版本，如果您系统中存在 /etc/php.d 目录，则需要将 eaccelerator.ini
文件复制到该目录中，并且根据需要修改其中的默认设置和数值。
如果系统中不存在 /etc/php.d 目录，则编辑 php.ini 文件（通常位于 /etc/php.ini）。
安装为 zend 扩展：
zend_extension=/usr/lib/php4/eaccelerator.so
eaccelerator.shm_size=16
eaccelerator.cache_dir=/tmp/eaccelerator
eaccelerator.enable=1
eaccelerator.optimizer=1
eaccelerator.check_mtime=1
eaccelerator.debug=0
eaccelerator.filter=
eaccelerator.shm_max=0
eaccelerator.shm_ttl=0
eaccelerator.shm_prune_period=0
eaccelerator.shm_only=0
eaccelerator.compress=1
eaccelerator.compress_level=9
如果您使用 thread safe 编译安装 php，则您必须使用 zend_extension_ts 代替 zend_extension。
安装为 php 扩展：
extension=eaccelerator.so
eaccelerator.shm_size=16
eaccelerator.cache_dir=/tmp/eaccelerator
eaccelerator.enable=1
eaccelerator.optimizer=1
eaccelerator.check_mtime=1
eaccelerator.debug=0
eaccelerator.filter=
eaccelerator.shm_max=0
eaccelerator.shm_ttl=0
eaccelerator.shm_prune_period=0
eaccelerator.shm_only=0
eaccelerator.compress=1
eaccelerator.compress_level=9
步骤 4. 创建缓存目录
mkdir /tmp/eaccelerator
chomd 0777 /tmp/eaccelerator
配置选项
eaccelerator.shm_size
指定 eaccelerator 能够使用的共享内存数量，单位：mb。
0 代表操作系统默认。默认值为 0。
eaccelerator.cache_dir
用户磁盘缓存的目录。eaccelerator 在该目录中存储预编译代码、session 数据、内容等。
相同的数据也可以存储于共享内存中（以获得更快的存取速度）。默认值为 /tmp/eaccelerator。
eaccelerator.enable
开启或关闭 eaccelerator。1 为开启，0 为关闭。默认值为 1。
eaccelerator.optimizer
开启或关闭内部优化器，可以提升代码执行速度。1 为开启，0 为关闭。默认值为 1。
eaccelerator.debug
开启或关闭调试日志记录。1 为开启，0 为关闭。默认值为 0。
eaccelerator.check_mtime
开启或关闭 php 文件改动检查。1 为开启，0 为关闭。如果您想要在修改后重新编译 php
程序则需要设置为 1。默认值为 1。
eaccelerator.filter
判断哪些 php 文件必须缓存。您可以指定缓存和不缓存的文件类型（如 *.php *.phtml等）
如果参数以 ! 开头，则匹配这些参数的文件被忽略缓存。默认值为 ，即，所有 php 文件
都将被缓存。
eaccelerator.shm_max
当使用 eaccelerator_put() 函数时禁止其向共享内存中存储过大的文件。该参数指定允许
存储的最大值，单位：字节 (10240, 10k, 1m)。0 为不限制。默认值为 0。
eaccelerator.shm_ttl
当 eaccelerator 获取新脚本的共享内存大小失败时，它将从共享内存中删除所有在
最后 shm_ttl 秒内无法存取的脚本缓存。默认值为 0，即：不从共享内春中删除
任何缓存文件。
eaccelerator.shm_prune_period
当 eaccelerator 获取新脚本的共享内存大小失败时，他将试图从共享内存中删除早于
shm_prune_period 秒的缓存脚本。默认值为 0，即：不从共享内春中删除
任何缓存文件。
eaccelerator.shm_only
允许或禁止将已编译脚本缓存在磁盘上。该选项对 session 数据和内容缓存无效。默认
值为 0，即：使用磁盘和共享内存进行缓存。
eaccelerator.compress
允许或禁止压缩内容缓存。默认值为 1，即：允许压缩。
eaccelerator.compress_level
指定内容缓存的压缩等级。默认值为 9，为最高等级。
eaccelerator.name_sapce
一个所有键(keys)的前缀字符串。如果设置该前缀字符串则允许 .htaccess 或者 主配置
文件在相同主机上运行两个相同的键名。
eaccelerator.keys
eaccelerator.sessions
eaccelerator.content
判断哪些键(keys)、session 数据和内容将被缓存。可用参数值为：
shm_and_disk - 同时在共享内存和磁盘中缓存数据（默认值）；
shm - 如果共享内存用尽或者数据容量大于 eaccelerator.shm_max
则在共享内存或磁盘中缓存数据；
shm_only - 仅在共享内存中缓存数据；
disk_only - 仅在磁盘中缓存数据；
none - 禁止缓存数据。
eaccelerator 应用程序接口(api)
eaccelerator_put($key, $value, $ttl=0)
将 $value 存储在共享内存中，并存储 $tll 秒。
eaccelerator_get($key)
从共享内存中返回 eaccelerator_put() 函数所存储的缓存数值，如果不存在或者已经
过期，则返回 null。
eaccelerator_rm($key)
从共享内存中删除 $key。
eaccelerator_gc()
删除所有过期的键(keys)
eaccelerator_lock($lock)
创建一个指定名称的锁(lock)。该锁可以通过 eaccelerator_unlock() 函数解除，在请求
结束时也会自动解锁。例如：
eaccelerator_unlock($lock)
解除指定名称的锁(lock)。
eaccelerator_set_session_handlers()
安装 eaccelerator session 句柄。
从 php 4.2.0 以后，您可以通过设置 php.ini 中的 session.save_handler=eaacelerator
安装 eaccelerator 句柄。
eaccelerator_cache_output($key, $eval_code, $ttl=0)
在共享内存中缓存 $eval_code 的输出，缓存 $ttl 秒。
可以调用 mmcach_rm() 函数删除相同 $key 的输出。例如：
eaccelerator_cache_result($key, $eval_code, $ttl=0)
在共享内存中缓存 $eval_code 的结果，缓存 $ttl 秒。
可以调用 mmcach_rm() 函数删除相同 $key 的结果。例如：
eaccelerator_cache_page($key, $ttl=0)
缓存整个页面，且缓存 $ttl 秒。例如：
eaccelerator_rm_page($key)
从缓存中删除由 eaccelerator_cache_page() 函数创建的相同 $key 的页。
eaccelerator_encode($filename)
返回 $filename 文件经过编译后的编码。
eaccelerator_load($code)
加载被 eaccelerator_encode() 函数编码过的脚本。
web 界面
可以通过 eaccelerator.php 进行基于 web 界面的管理。当然，您需要将该文件存储于您的 web 站点
目录中。出于安全原因，建议您对该文件进行安全控制，保证只有本地 ip 才能读取该文件。
从 2.3.18 版本开始，管理界面可以进行密码保护。从终端命令行运行 eaccelerator_password.php 并
按照以下步骤生成密码：
$ php -q eaccelerator_password.php
更改 eaccelerator web 管理界面密码。(eaccelerator.php)
enter admin name：admin
new admin password: eaccelerator
retype new admin password: eaccelerator
在 php.ini 中添加以下内容，并且重新启动 web 服务：
eaccelerator.admin.name=admin
eaccelerator.admin.password=$1$0scd9gkb$noemfernmvq576helelrg0
如果在受 httpd 密码保护的目录中存放 eaccelerator.php，则 eaccelerator 的管理员用户名和密码
必须一致。
联系我们
您可以联系我们以报告 bugs、提问或者补丁。发送电子邮件给 bart vanbrabant