Version 17 (modified by moo, 13 years ago) (diff)



Frequently Asked Questions

Where to get help?

freenode, channel #lighttpd (temporary)
XCache Forum.

Why XCache?

see Introduction

Where Is ./configure?

Well... you have to install php first, which gives you "phpize" executable(script), and do

~/src/xcache $ phpize
(generating configure)
~/src/xcache $ ./configure --help
~/src/xcache $ ./configure --enable-...

How to install from source?

follow the instructions in GettingSource, BuildingFromSource, InstallingAsPhpExtension

What if i'm getting "undefined symbol"

If your php is configured --enable-versioning, disable it. It's broken. If you insist on versioning, build XCache as a static module of php.

Apache2 keeps getting segmentation faults with cache larger than 4M

Set "xcache.readonly_protection = On" in php.ini

I get "Cannot dynamically load"

When u get PHP Warning: Unknown(): Cannot dynamically load - dynamic modules are not supported in Unknown on line 0, it's because your php is running on a arch/os that don't support dynamic load library(aka modules), to solve it:

~ $ mv xcache php-src/
~ $ cd php-src/
~/php-src $ ./buildconf --force
~/php-src $ ./config.nice --enable-xcache --enable-xcache-coverager
(or if you havn't run configure yet, use:)
~/php-src $ ./configure --enable-xcache --enable-xcache-coverager --your-options
~/php-src $ make all
~/php-src $ make install

Why is misses > 0 no matter how I increase the shm size?

"Misses" a opp to "hits". You get cache misses when there's nothing in the cache in the first time, after when it is cached and you starts getting cache hits. So there shall be at least misses=count(cached-php).

Why is my cache being cleared?

Set PHP_FCGI_CHILDREN to 1 or greater if you're using php FastCGI.

And see the following.

I see jumpy "hits" in admin page

It is possible that u see jumpy "hits" count in admin page. i.e.: you see hits=300,000 on first load of admin page, but dropped to hits=1 in 2nd reload and back to hits=312,456 on 3rd load.

This is because you have php started in different group which does not share shm with each other. But keep in mind that all childs in 1 group will share shm. So how to check and make it 1 group only?


Good Exmaple

$ pstree -p
        |              |-supervise(4913)---lighttpd(23975)-+-php-cgi(23979)-+-php-cgi(23981)
        |              |                                   |                |-php-cgi(23982)
        |              |                                   |                |-php-cgi(23983)
        |              |                                   |                `-php-cgi(23984)

Bad Exmaple

$ pstree -p
        |              |-supervise(4913)---lighttpd(23975)-+-php-cgi(23979)-+-php-cgi(23981)
        |              |                                   |                |-php-cgi(23982)
        |              |                                   |                |-php-cgi(23983)
        |              |                                   |                `-php-cgi(23984)
                       |                                   +-php-cgi(23980)-+-php-cgi(23985)
        |              |                                   |                |-php-cgi(23986)
        |              |                                   |                |-php-cgi(23987)
        |              |                                   |                `-php-cgi(23988)

See also:

Help! I get error about "XCache requires Zend Engine API version NNN"

XCache requires Zend Engine API version 220051025.
The Zend Engine API version 220060519 which is installed, is newer.
Contact mOo at for a later version of 

You get this error because you have an outdated build of XCache. i.e., you have upgraded php undefined symbol: OnUpdateLong?

See above.