Integrating XCache Into PHP5 (OpenSUSE 10.3 & Apache2)

Version 1.0
Author: Falko Timme

This guide explains how to integrate XCache into PHP5 on an OpenSUSE 10.3 system (with Apache2). From the XCache project page: "XCache is a fast, stable PHP opcode cacher that has been tested and is now running on production servers under high load." It's similar to other PHP opcode cachers, such as eAccelerator and APC.

I do not issue any guarantee that this will work for you!


1 Preliminary Note

I have tested this on an OpenSUSE 10.3 server with the IP address where Apache2 and PHP5 are already installed and working. I'll use Apache's default document root /srv/www/htdocs in this tutorial for demonstration purposes. Of course, you can use any other vhost as well, but you might have to adjust the path to the info.php file that I'm using in this tutorial.


2 Checking PHP5's Current State

First, before we install XCache, let's find out about our PHP5 installation. To do this, we create the file info.php in our document root /srv/www/htdocs:

vi /srv/www/htdocs/info.php

Afterwards, we call that file in a browser:

As you see, we have PHP 5.2.5 installed...

... but XCache isn't mentioned anywhere on the page:


3 Installing XCache

Unfortunately XCache isn't available as an rpm package for OpenSUSE 10.3, therefore we have to build it from the sources. First we install all packages that we need to build XCache:

yast2 -i gcc flex wget gcc-c++ make php5-devel

Next we download and uncompress the latest XCache version:

cd /tmp
tar xvfz xcache-1.2.2.tar.gz

Then we go to the new XCache source directory...

cd xcache-1.2.2

... and build XCache as follows:

./configure --enable-xcache
make install

Next we copy xcache.ini to the /etc/php5/conf.d directory:

cp xcache.ini /etc/php5/conf.d

Now we must configure XCache. The configuration options are explained here: The least you should do is enable extension = and disable all zend_extension lines; furthermore, set xcache.size to a size (in MB) > 0 to enable XCache:

vi /etc/php5/conf.d/xcache.ini
;; install as zend extension (recommended), normally "$extension_dir/"
;zend_extension = /usr/local/lib/php/extensions/non-debug-non-zts-xxx/
; zend_extension_ts = /usr/local/lib/php/extensions/non-debug-zts-xxx/
;; For windows users, replace with php_xcache.dll
;zend_extension_ts = c:/php/extensions/php_xcache.dll
;; or install as extension, make sure your extension_dir setting is correct
extension =
;; or win32:
; extension = php_xcache.dll
xcache.size  =                32M

That's it. Restart Apache, and you're done:

/etc/init.d/apache2 restart

Afterwards, open info.php again in a browser:

You should now see XCache mentioned on the page which means it has successfully been integrated and is working as expected:


Share this page:

Suggested articles

2 Comment(s)

Add comment




 I was just reading your very helpful article on integrating Xcache into PHP5, great job. I would just like to point out however that you can get the RPM for it from the opensuse build service. (I use the site almost daily)



Grazie (italian for  tank you), but you forget to move also into /usr/lib/php5/extensions

just type

cp modules/ /usr/lib/php5/extensions