Installer l'extension PHP XCache sur Debian

Ce guide est testé sur:

• Debian 6.0 Squeeze
• Debian 7.0 Wheezy
• Ubuntu 10.04 Lucid Lynx
• Ubuntu 10.10 Maverick Meercat
• Ubuntu 11.04 Natty Narwal

Avertissement

Cet article est incompatible avec ces guides:

• Installer l'extension PHP APC sur Debian.

Prérequis

Ce guide nécessite:

• une installation fonctionnelle de PHP, comme décrite par Installer PHP-FPM sur Debian.

Installation depuis les dépôts

Installez le logiciel:

command apt-get -y install php5-xcache

Rechargez la configuration:

test -e '/etc/init.d/php5-fpm' && command service 'php5-fpm' 'restart'
test -e '/etc/init.d/apache2' && command service 'apache2' 'force-reload'

Configuration

Détectez le chemin des fichiers de configuration des extensions PHP:

MODS_CONF_PATH='/etc/php5/conf.d'
test -d '/etc/php5/mods-available' \
  && MODS_CONF_PATH='/etc/php5/mods-available'

Configurez la quantité de mémoire disponible pour le cache:

echo "; Local configuration for php XCache module
; priority=50
xcache.size = 60M
xcache.var_size = 4M" \
  > "${MODS_CONF_PATH}/xcache-config.ini"
test -n "$(command -v php5enmod)" && command php5enmod 'xcache-config/50'

Pour utiliser XCache avec Symfony 1.0, désactivez l'identification de l'admin. Le code Symfony 1.0 peut alors utiliser la fonction xcache_count (dangereux):

# command echo -e "; Disable cache admin auth for Symfony 1.0\nxcache.admin.enable_auth = Off" >> "${MODS_CONF_PATH}/xcache-config.ini"

Rechargez la configuration:

test -e '/etc/init.d/php5-fpm' && command service 'php5-fpm' 'restart'
test -e '/etc/init.d/apache2' && command service 'apache2' 'force-reload'

Installation manuelle

Si le paquet Debian n'existe pas, installez l'extension manuellement.

Détectez le chemin des fichiers de configuration des extensions PHP:

MODS_CONF_PATH='/etc/php5/conf.d'
test -d '/etc/php5/mods-available' \
  && MODS_CONF_PATH='/etc/php5/mods-available'

Détectez le numéro de la dernière version de l'extension:

VERSION=$(command wget 'http://xcache.lighttpd.net/pub/Releases/' \
    --quiet  --output-document=- \
    | command grep "href=" \
    | command egrep -v "(-rc|-beta)" \
    | command sed -e 's|^.*href="\([^/]*\)/".*$|\1|' \
    | command sort \
    | command tail -n 1)

Préparation de l'environnement

installez les logiciels nécessaires:

command apt-get install php5-dev make

Mise en place du logiciel

Téléchargez les sources:

command wget "http://xcache.lighttpd.net/pub/Releases/${VERSION}/xcache-${VERSION}.tar.gz" \
    --output-document="/tmp/xcache-${VERSION}.tar.gz"

Décompressez l'archive:

command tar --directory='/tmp' -xzf "/tmp/xcache-${VERSION}.tar.gz"

Compilez et installez l'extension:

command pushd "/tmp/xcache-${VERSION}"
command phpize --clean
command phpize
./configure --enable-xcache
command make
command make install
command popd

Activez l'extension:

echo "; configuration for php XCache module
; priority=20
extension=xcache.so" > "${MODS_CONF_PATH}/xcache.ini"
test -n "$(command -v php5enmod)" && command php5enmod 'xcache'

Rechargez la configuration:

test -e '/etc/init.d/php5-fpm' && command service 'php5-fpm' 'restart'
test -e '/etc/init.d/apache2' && command service 'apache2' 'force-reload'

Vous pouvez maintenant configurer XCache.

Remerciements

• Merci aux développeurs de XCache (en).