eaccelerator 完全手册：配置、控制、API接口

安装官方有很详细的文档

转自 http://www.enjoyphp.com/2010/eaccelerator-manual/

配置选项

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

1

<?php

2	eaccelerator_lock("count");

3	eaccelerator_put("count",eaccelerator_get("count")+1));

4

?>

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

1

<?php

2	eaccelerator_cache_output('test'，'echo time(); phpinfo();'，30);

3

?>

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

1

<?php

2	eaccelerator_cache_output('test'，'time()." Hello";'，30);

3

?>

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

1

<?php

2	eaccelerator_cache_page($_SERVER['PHP_SELF'].'?GET='.serialize($_GET),30);

3	echo time();

4	phpinfo();

5

?>

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