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