LO QUE VAMOS A VER

Servicio, extensión de PHP y caché de objetos son piezas distintas. Revisamos el despliegue actual de cPanel y cómo comprobar cada una sin vaciar la caché compartida.

Memcached permite guardar datos temporales en memoria para evitar cálculos o consultas repetidos. En un servidor con cPanel y WHM hay que distinguir el servicio de caché, el cliente de PHP y la integración de la aplicación. Instalar uno de ellos no activa automáticamente los demás ni garantiza una mejora de rendimiento.

El procedimiento antiguo con ea4-experimental, chkconfig y reinicios genéricos de Apache ya no debe utilizarse como receta actual. Esta revisión sigue la vía documentada por cPanel para Memcached en contenedores de EasyApache 4. Si tu proveedor ya gestiona el servicio, utiliza su configuración y no instales una segunda instancia.

Comprobar requisitos y elegir el cliente

Servicio, extensión e integración son capas distintas

  • Memcached es el servicio que almacena los datos temporales. No es una base de datos ni una copia de seguridad.
  • memcached y memcache son extensiones diferentes de PHP, con APIs distintas. La integración que elijas determinará cuál necesita; no instales ambas por rutina.
  • La aplicación necesita una integración que utilice ese servicio: por ejemplo, un proveedor de caché de objetos persistente en WordPress.

Revisa en MultiPHP Manager la versión de PHP del dominio y cómo se ejecuta. El PHP de una consola puede ser distinto del PHP-FPM o del controlador que atiende la web. En CloudLinux, un PHP gestionado por su selector puede seguir otro procedimiento que los paquetes ea-php.

Permisos y plataforma

La preparación del servidor corresponde al administrador con acceso root a WHM o SSH. La creación del contenedor se hace después como usuario de la cuenta cPanel, con acceso a consola. Una cuenta de alojamiento compartido sin esos permisos debe solicitarlo al proveedor.

cPanel documenta sus contenedores de EasyApache 4 para AlmaLinux, Rocky Linux y Ubuntu. CloudLinux tiene otro enfoque de contenedores que esta vía de cPanel no cubre. Confirma además que la versión y la virtualización del servidor admiten la configuración; no extrapoles estos comandos a un Ubuntu sin cPanel.

Preparar Memcached mediante contenedores

Preparación del administrador

En un servidor compatible, prepara los contenedores siguiendo la documentación de EasyApache 4 Containers. Como root, en AlmaLinux o Rocky Linux:

Código
dnf install ea-podman-repo
dnf install ea-podman

En Ubuntu con cPanel, la alternativa es:

Código
apt install ea-podman-repo
apt update
apt install ea-podman

Después instala el paquete que proporciona la imagen de Memcached, usando únicamente el gestor que corresponda al sistema:

Código
dnf install ea-memcached16

O, en Ubuntu con cPanel:

Código
apt install ea-memcached16

Lee la propuesta de paquetes antes de confirmar. La preparación puede necesitar ajustes propios del servidor; si falla, consulta el error y las instrucciones de cPanel. No añadas repositorios experimentales ni sustituyas archivos globales de contenedores para ocultar el fallo.

Crear el servicio para la cuenta

Inicia una sesión SSH o Terminal como el usuario de la cuenta cPanel y ejecuta:

Código
/usr/local/cpanel/scripts/ea-podman install ea-memcached16

Consulta después los contenedores registrados y en ejecución:

Código
/usr/local/cpanel/scripts/ea-podman registered
/usr/local/cpanel/scripts/ea-podman running

cPanel distingue esta sesión de usuario de la preparación root. No ejecutes el script como si fuera un servicio global ni lo invoques mediante su - o sudo -E. Si no puedes abrir la sesión requerida, pide al administrador que prepare el acceso adecuado.

Identifica el socket memcache.sock que expone la instalación y su ruta accesible desde el PHP de la cuenta. La información del contenedor se guarda bajo ~/ea-podman.d/; comprueba el montaje y la ruta efectiva en tu servidor, sin deducirlos únicamente del nombre del contenedor. La aplicación necesita la ruta real, no un texto con ~ pendiente de expandir.

Un socket Unix evita publicar un puerto de Memcached, pero sus permisos y los directorios que lo contienen deben permitir el acceso al proceso PHP correcto. No lo resuelvas con permisos abiertos a todo el servidor. Si utilizas otro despliegue con TCP, limita los clientes a una red de confianza y no expongas Memcached a Internet.

Habilitar PHP y comprobar la conexión

Activar la extensión para el PHP del dominio

En WHM → Software → EasyApache 4, revisa las extensiones disponibles para la versión seleccionada y aprovisiona la que necesita tu integración. Los paquetes siguen el patrón ea-php83-php-memcached, con 83 como ejemplo de PHP 8.3; verifica la disponibilidad y la compatibilidad en tu plataforma.

Prioriza el paquete mantenido por el proveedor cuando exista. Si necesitas PECL, utiliza las herramientas de la versión de PHP correspondiente y documenta su mantenimiento; no mezcles a ciegas una compilación manual y un paquete que ya gestiona la misma extensión.

Como comprobación en consola, para PHP 8.3 de EasyApache:

Código
/usr/local/bin/ea-php83 -v
/usr/local/bin/ea-php83 --ini
/usr/local/bin/ea-php83 --ri memcached

Cambia 83 por la versión real del dominio. --ri memcached debe mostrar la extensión, pero solo acredita ese PHP de consola. Verifica también su carga en el entorno que atiende la web con las herramientas del proveedor o una comprobación temporal protegida; no dejes un phpinfo() público.

Si el proceso PHP necesita recargarse, utiliza el mecanismo de cPanel que corresponda a su controlador. No reinicies todo Apache por rutina ni ignores un error de arranque.

Probar el socket sin vaciar la caché

Guarda este archivo como comprobar-memcached.php fuera del directorio público y ejecútalo desde la cuenta autorizada. Utiliza una clave aleatoria con caducidad de 60 segundos, comprueba su lectura y retira solo esa clave:

Código
<?php
// Ejecutar desde una consola, fuera del directorio público de la web.
if ( PHP_SAPI !== 'cli' || $argc !== 2 || ! str_starts_with( $argv[1], '/' ) ) {
    fwrite( STDERR, "Uso: php comprobar-memcached.php /ruta/real/memcache.sock\n" );
    exit( 2 );
}

$socket = @stream_socket_client( 'unix://' . $argv[1], $errno, $error, 2 );
if ( $socket === false ) {
    fwrite( STDERR, "No se pudo conectar al socket. Revisa ruta, servicio y permisos.\n" );
    exit( 1 );
}
stream_set_timeout( $socket, 2 );

function rjc_demo_memcached_command( $socket, $command ) {
    $remaining = $command;
    while ( $remaining !== '' ) {
        $written = fwrite( $socket, $remaining );
        if ( $written === false || $written === 0 ) {
            throw new RuntimeException( 'No se pudo enviar la petición.' );
        }
        $remaining = substr( $remaining, $written );
    }
}

try {
    $key = 'rjc-check-' . bin2hex( random_bytes( 12 ) );
    $value = 'conexion-correcta';
    rjc_demo_memcached_command( $socket, "set $key 0 60 " . strlen( $value ) . "\r\n$value\r\n" );
    if ( fgets( $socket ) !== "STORED\r\n" ) {
        throw new RuntimeException( 'No se pudo guardar la clave de prueba.' );
    }

    rjc_demo_memcached_command( $socket, "get $key\r\n" );
    $expected = "VALUE $key 0 " . strlen( $value ) . "\r\n";
    if ( fgets( $socket ) !== $expected || fgets( $socket ) !== "$value\r\n" || fgets( $socket ) !== "END\r\n" ) {
        throw new RuntimeException( 'La lectura no coincide con el valor guardado.' );
    }

    rjc_demo_memcached_command( $socket, "delete $key\r\n" );
    if ( fgets( $socket ) !== "DELETED\r\n" ) {
        throw new RuntimeException( 'No se pudo retirar la clave de prueba.' );
    }
    echo "Conexión, escritura y lectura correctas; clave de prueba eliminada.\n";
} catch ( Throwable $error ) {
    fwrite( STDERR, $error->getMessage() . "\n" );
    exit( 1 );
} finally {
    fclose( $socket );
}

Ejecuta el archivo con la ruta real del socket:

Código
/usr/local/bin/ea-php83 comprobar-memcached.php /ruta/real/memcache.sock

La prueba utiliza el protocolo de texto mediante streams de PHP: comprueba conexión, escritura y lectura desde esa consola, pero no utiliza ni valida la extensión memcached. Tampoco demuestra que PHP-FPM tenga los mismos permisos o que WordPress esté conectado. Si falla tras guardar la clave, esta queda limitada por su caducidad; no se envía flush_all.

Integrar WordPress y medir el resultado

En WordPress necesitas una integración mantenida de caché de objetos persistente compatible con el cliente y con sockets Unix. Configura el socket con el formato que exige esa integración. Algunas esperan una ruta y puerto 0; otras utilizan su propia estructura de configuración. No copies parámetros de un plugin a otro.

Revisa si ya existe wp-content/object-cache.php y qué herramienta lo gestiona antes de sustituirlo. Es el drop-in de caché de objetos; advanced-cache.php corresponde a otro mecanismo. Añadir WP_CACHE por sí solo no conecta WordPress a Memcached.

Comprueba el estado que muestra la integración y Salud del sitio. Después verifica con sus herramientas que se reutilizan valores entre peticiones distintas: una lectura correcta dentro de una sola petición no acredita persistencia. No uses una limpieza global para hacer esa prueba en un servicio compartido.

Si varias webs utilizan una misma instancia, evita colisiones con la separación de claves que admita la integración. Un prefijo no es aislamiento de seguridad frente a otro cliente que pueda acceder al servicio. Para cuentas con distinta confianza, utiliza instancias y permisos separados.

Mide antes y después con una carga comparable: tiempos de respuesta, consultas, aciertos y desalojos de caché, memoria y errores. La aplicación debe poder regenerar estos datos cuando caduquen, se desalojen o el servicio se reinicie. No almacenes información irrecuperable únicamente en Memcached.

Antes de dar la instalación por terminada, verifica las tres capas: el servicio es accesible, el PHP de la web tiene el cliente necesario y la aplicación reutiliza la caché entre peticiones.

Referencias: Memcached en contenedores de cPanel, gestión con ea-podman, extensiones PHP de EasyApache 4, configuración de Memcached y caché de objetos en WordPress.

CONVERSAMOS SOBRE LA GUÍA

Preguntas y aportaciones

Deja tu comentario

Tu correo no se publicará. Revisamos los comentarios antes de publicarlos. No incluyas información privada.

Utilizaremos los datos para gestionar la conversación y protegerla frente al spam. Consulta la política de privacidad.

La conversación

2 aportaciones

Conservamos las conversaciones y sus fechas originales. Algunas se refieren a versiones anteriores; consulta el contenido revisado de la guía antes de aplicar sus indicaciones.

  1. Hola RJCardenas:

    En el apartado "Home »Software »EasyApache 4" personalizar (Customize) los paquetes instalados (Currently Installed Packages) y finalmente "PHP Extensions" hay dos opciones muy parecidas para activar:

    php72-php-memcache 4.0.3-4.4.8.cpanel (x)
    memcache extension for ea-php72

    y

    php72-php-memcached 3.1.3-5.5.8.cpanel (x)
    php-memcached extension for ea-php72

    ¿Son estas opciones lo mismo que comentas en el apartado de Software?

    Mi servidor es CENTOS 7.8, WHM v86.0.24.

    Felicitaciones muy buen aporte a la comunidad de cpanel.

    Responder
    1. RJCardenasAutor

      Hola Wiliam,
      Esas son las dos extensiones que comento. En realidad cumplen la misma función (son librerías de PHP para interactuar com el dademon de memcached).
      memcache es la más antigua, no tiene dependencias y al parecer es algo más rápida. Pero no incorpora todas las funcionaliddes.
      memcached es más nueva e implementa todas las opciones del protocolo (por ejemplo guardar información binaria), depende de libmemcached.
      Se pueden utilizar cualquiera de las dos.
      Yo recomiendo ambas en el artículo, porque lo normal en CPANEL es tener diferentes sitios y configuraciones. Soportar ambas librerías da más juego

      Gracias por tu comentario y espero haberte ayudado

      Responder