eaccelerator 完全手册:下载、安装、配置、控制、API接口

eAccelerator是一个开源的PHP加速器、优化器、编码器,同时也能够为PHP提供动态内容缓存。它能够将 PHP 脚本缓存为已编译状态以达到提升 PHP 脚本运行性能的目的,因此传统的预编译几乎被消除。eAccelerator 也能够优化 PHP 脚本以提升 PHP 脚本的执行速度。eAccelerator 可有效降低服务器负载并且提高 PHP 程序速度达 1-10 倍.
eAccelerator 是 Turck MMCache 的一个分支 。
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 站点获取更多有关安装方面的信息。

有关 Microsoft Windows 平台的安装信息,请阅读 README.win32 file。

步骤 1。编译 eAccelerator


export PHP_PREFIX="/usr"
$PHP_PREFIX/bin/phpize
./configure  --enable-eaccelerator=shared   --with-php-config=$PHP_PREFIX/bin/php-config –with-eaccelerator-info
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
chmod 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.allowed_admin_path
该脚本路径允许获得管理信息并进行管理控制.

控制面板和分解器(disassembler)

如果您想要使用控制面板,您需要以下面方式编译eAccelerator

–with-eaccelerator-info 这是默认值.
您需要将 control.php 复制到您的网站根目录下,并将 php.ini 或 eaccelerator.ini 中的 eaccelerator.allowed_admin_path 设置路径到此文件。如果您没有这样做,则您不能看到更多的信息,并且也不能控制 eAccelerator.
您可以在 control.php 中设置访问控制面板所需要的用户名和密码.
当您以 –with-eaccelerator-disassembler 方式编译 eAccelerator 时,您需要将 dasm.php 和 PHP_Highlight.php 文件放在与 control.php 文件同样的目录下。分解器(disassembler)需要将 PHP 编译为支持 tokenizer (–enable-tokenizer).
您可以在 dasm.php 文件的顶部设置访问分解器(disassembler)的用户名和密码.

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() 函数解除,在请求结束时也会自动解锁。例如:


<?php
eaccelerator_lock("count");
eaccelerator_put("count",eaccelerator_get("count")+1));
?>

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 的输出。例如:


<?php
eaccelerator_cache_output('test','echo time(); phpinfo();',30);
?>

eaccelerator_cache_result($key,$eval_code,$ttl=0)
在共享内存中缓存 $eval_code 的结果,缓存 $ttl 秒。可以调用 mmcach_rm() 函数删除相同 $key 的结果。例如:


<?php
eaccelerator_cache_output('test','time()." Hello";',30);
?>

eaccelerator_cache_page($key,$ttl=0)
缓存整个页面,且缓存 $ttl 秒。例如:


<?php
eaccelerator_cache_page($_SERVER['PHP_SELF'].'?GET='.serialize($_GET),30);
echo time();
phpinfo();
?>

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 的管理员用户名和密码必须一致.


( ! ) Warning: Missing argument 1 for cwppos_show_review(), called in /data/www/enjoyphp/wp-content/themes/flat/content-single.php on line 29 and defined in /data/www/enjoyphp/wp-content/plugins/wp-product-review/includes/legacy.php on line 18
Call Stack
#TimeMemoryFunctionLocation
10.0000355208{main}( ).../index.php:0
20.0001355496require( '/data/www/enjoyphp/wp-blog-header.php' ).../index.php:17
30.168610191200require_once( '/data/www/enjoyphp/wp-includes/template-loader.php' ).../wp-blog-header.php:19
40.169810262344include( '/data/www/enjoyphp/wp-content/themes/flat/single.php' ).../template-loader.php:74
50.247510820944get_template_part( ).../single.php:5
60.247510821464locate_template( ).../general-template.php:167
70.247510821560load_template( ).../template.php:643
80.247610821944require( '/data/www/enjoyphp/wp-content/themes/flat/content-single.php' ).../template.php:686
90.258310815248cwppos_show_review( ).../content-single.php:29

1 评论

发表评论

电子邮件地址不会被公开。 必填项已用*标注