Fix "Memcache Extension is Not Loaded" in Bitrix

Table of Contents: Introduction Check if Memcache is Installed Install Memcache Extension Enable in PHP Configuration Configure for Bitrix Test Memcache Summary of Fixes

If Bitrix (Bitrix24) shows the error "Memcache extension is not loaded", it means the Memcache PHP extension is missing or not enabled. This guide will help you install and configure Memcache correctly to improve your Bitrix site's performance through caching.

1. Check if Memcache is Installed

First, verify whether the Memcache extension is already present on your system.

php -m | grep memcache

Expected Results:

• If you see memcache or memcached in the output, the extension is installed but may not be enabled for your web server's PHP configuration.
• If there's no output, the extension is not installed and needs to be installed.

Also check if the Memcached service is running:

systemctl status memcached

And verify your PHP version to install the correct package:

php -v

2. Install the Memcache Extension

Memcache requires two components: the Memcached service/daemon and the PHP extension.

Step 1: Install Memcached Service

sudo apt update
sudo apt install memcached libmemcached-tools -y

sudo yum install memcached -y

After installation, start and enable the service:

sudo systemctl start memcached
sudo systemctl enable memcached

Step 2: Install PHP Memcache Extension

sudo apt install php7.4-memcache php7.4-memcached -y

sudo apt install php8.0-memcache php8.0-memcached -y

sudo apt install php8.1-memcache php8.1-memcached -y

# Enable Remi repository first if needed
sudo yum install php-pecl-memcache php-pecl-memcached -y

Verify Installation

# Check both extensions
php -m | grep -E "memcache|memcached"

# You should see both memcache and memcached listed

3. Enable Memcache in PHP Configuration

If the extension is installed but not being loaded by your web server's PHP, you need to enable it in the appropriate php.ini file.

Find the Correct php.ini File

# For command-line PHP (initial check)
php --ini | grep "Loaded Configuration File"

# For web server PHP (may be different)
sudo find /etc -name "php.ini" | grep -E "(apache2|fpm|httpd)"

Edit php.ini

# For Apache on Ubuntu/Debian
sudo nano /etc/php/7.4/apache2/php.ini

# For PHP-FPM (Nginx) on Ubuntu/Debian
sudo nano /etc/php/7.4/fpm/php.ini

# For CentOS/RHEL
sudo nano /etc/php.ini

Add or Uncomment Extensions

Search for or add these lines in the extensions section:

extension=memcache.so
extension=memcached.so

Save the file (Ctrl+O, Enter, Ctrl+X).

Restart Web Services

# For Apache
sudo systemctl restart apache2

# For Nginx with PHP-FPM
sudo systemctl restart php7.4-fpm
sudo systemctl restart nginx

# For CentOS Apache
sudo systemctl restart httpd

# Always restart Memcached service too
sudo systemctl restart memcached

Verify Extension is Loaded

php -m | grep -E "memcache|memcached"

4. Configure Memcache for Bitrix

After installing and enabling the extension, configure Bitrix to use Memcache for caching.

Edit Bitrix Configuration File

sudo nano /home/user/public_html/bitrix/php_interface/dbconn.php

Replace /home/user/public_html/ with your actual Bitrix installation path.

Add Memcache Configuration

Find the section where cache settings are defined (usually near the end) and add or modify:

// Memcache configuration for Bitrix
define("BX_CACHE_TYPE", "memcache");
define("BX_MEMCACHE_HOST", "127.0.0.1");
define("BX_MEMCACHE_PORT", "11211");
define("BX_CACHE_SID", $_SERVER["DOCUMENT_ROOT"]."|site");

// Optional: Use Memcached instead (recommended)
// define("BX_CACHE_TYPE", "memcached");

// For multiple Memcache servers (clustered setup)
// define("BX_MEMCACHE_HOST", "mem1.site.com;mem2.site.com");

Alternative: Configure via Bitrix Admin Panel

1. Log into your Bitrix Admin Panel
2. Go to Settings > System Settings > Cache Settings
3. Select Memcache or Memcached as cache type
4. Enter server details: 127.0.0.1:11211
5. Save and clear cache

5. Test Memcache Installation

Method 1: PHP Info Test

# Create a test file (in a secure location, not web root for production)
echo "<?php phpinfo(); ?>" | sudo tee /home/user/public_html/test_memcache.php

Visit http://yourdomain.com/test_memcache.php and search for "memcache" or "memcached". You should see configuration sections for both extensions.

sudo rm /home/user/public_html/test_memcache.php

Method 2: Command Line Test

# Test Memcached service connectivity
echo "stats" | nc 127.0.0.1 11211

# Test PHP Memcache functionality
php -r "\$mem = new Memcache; \$mem->connect('127.0.0.1', 11211); echo \$mem->getVersion();"

Method 3: Bitrix Cache Test

1. In Bitrix Admin Panel, go to Settings > System Settings > Performance
2. Check if Memcache is detected in the cache section
3. Run the cache test tool if available

6. Summary of Fixes

With Memcache properly installed and configured, Bitrix will use memory-based caching to significantly improve page load times and reduce database load!