Cuando WordPress o un plugin falla con un error de agotamiento de memoria, la solución consiste en aumentar el límite de memoria de PHP, y en KapsuleHost eso es un menú desplegable en KPanel en lugar de una edición de archivo. Esta guía explica qué significa el error, cómo cambiar el límite, qué valor elegir y qué hacer cuando más memoria no soluciona el problema.
Qué Aspecto Tiene el Error
La forma más clara es un error fatal impreso en la página o escrito en su registro de errores:
Fatal error: Allowed memory size of 268435456 bytes exhausted (tried to allocate 20480 bytes)
Divida la cifra en bytes entre 1.048.576 para leerla en megabytes: 268435456 son 256 MB, 134217728 son 128 MB.
No siempre se anuncia con tanta claridad. El mismo problema subyacente aparece como:
- Una página completamente en blanco sin ningún mensaje, a menudo en una pantalla específica.
- El panel de WordPress cargando con normalidad, pero una sola página de administración (Plugins, Productos, Salud del sitio) fallando.
- Una carga de medios o una importación que avanza parcialmente y se detiene.
- Un error 500 que solo aparece bajo carga.
Antes de cambiar nada, confirme que realmente se trata de memoria. Abra Configuración del sitio, luego la pestaña PHP, desplácese hasta Registro de errores de PHP y haga clic en Cargar registro. Esto muestra las últimas 200 entradas con un filtro de nivel. Un error de agotamiento de memoria aparece como Fatal. Si el registro está vacío, el problema está en otra parte: consulte Pantalla Blanca de WordPress y Lectura de Sus Registros de Errores.
Cambiar el Límite en KPanel
- Inicie sesión en KPanel y haga clic en Sitios web en la barra lateral izquierda.
- Haga clic en el sitio que desea cambiar.
- En el menú propio del sitio, abra Configuración y luego PHP.
- Busque la tarjeta Configuración de PHP y la fila Límite de memoria.
- Elija un valor en el menú desplegable:
128M,256M,512M,1024Mo2048M. - Haga clic en Guardar configuración.
No es necesario reiniciar nada y el sitio permanece activo durante todo el proceso. Su configuración se escribe en un archivo .user.ini en la raíz de su sitio, que KPanel gestiona por usted.
El nuevo valor no siempre está disponible en la siguiente carga de página. El servidor almacena en caché .user.ini hasta por cinco minutos, así que si todavía se informa el límite antiguo, espere unos minutos y vuelva a comprobarlo antes de suponer que el cambio no se aplicó.
La misma tarjeta controla otros cuatro valores que a menudo necesitan ajustarse junto con la memoria:
| Configuración | Opciones | Auméntelo cuando |
|---|---|---|
| Límite de memoria | 128M a 2048M | Errores fatales de memoria, pantallas de administración en blanco |
| Tiempo máximo de ejecución | 30 a 600 segundos | Importaciones, exportaciones y generación de informes que se detienen a mitad de camino |
| Tamaño máximo de carga | 16M a 256M | Un archivo zip de tema o un vídeo se rechaza por ser demasiado grande |
| Variables de entrada máximas | 1000 a 10000 | Menús grandes, formularios extensos, productos con muchas variaciones |
El tamaño máximo de publicación (post max size) no se muestra porque KapsuleHost lo establece automáticamente, siempre 1 MB por encima de su límite de carga, de modo que un formulario con un archivo en el límite siga cabiendo.
Qué Valor Elegir
Todos los sitios de KapsuleHost comienzan en 256M, lo cual ya es el doble del valor predeterminado de WordPress y suficiente para la gran mayoría de los sitios. Suba de valor solo cuando tenga un error real.
| Sitio | Límite sugerido |
|---|---|
| Sitio tipo folleto o blog con un tema ligero | 256M es más que suficiente |
| Sitio con un tema de constructor de páginas con 20 o más plugins | 256M, luego 512M si los errores persisten |
| Tienda WooCommerce, catálogo modesto | 256M |
| WooCommerce con suscripciones, muchas variaciones o plugins de inventario pesados | 512M |
| Red multisitio o sitio de membresía grande | 512M a 1024M |
No pase directamente a 2048M. Un límite muy alto no hace que un sitio sea más rápido: permite que un plugin descontrolado consuma mucha más capacidad del servidor antes de fallar, lo que convierte una sola página rota en un sitio lento para todos los visitantes. Suba un escalón, vuelva a probar y deténgase en cuanto el error desaparezca.
Establecer un Límite en wp-config.php
El menú desplegable de KPanel establece el límite del servidor. WordPress tiene sus propias dos constantes que solicitan memoria hasta ese límite, y parte de la documentación le indicará que las configure:
define( 'WP_MEMORY_LIMIT', '256M' );
define( 'WP_MAX_MEMORY_LIMIT', '512M' );
WP_MEMORY_LIMIT se aplica a la parte pública del sitio. WP_MAX_MEMORY_LIMIT se aplica al área de administración, que normalmente necesita más. Agréguelas encima de la línea /* That's all, stop editing! */ en wp-config.php, usando el editor integrado en Configuración, luego Gestor de archivos, o mediante SFTP.
Una constante de WordPress nunca puede superar el límite del servidor. Establecer WP_MEMORY_LIMIT en 1024M mientras el menú desplegable de KPanel indica 256M le da 256M y una falsa sensación de que lo solucionó. Suba siempre primero el valor en KPanel.
Para la mayoría de las personas, las constantes son innecesarias. Establezca el valor en KPanel y deje wp-config.php tal como está.
Notas sobre WooCommerce
Las tiendas son el motivo más habitual para superar los 256M. Compruebe la propia vista de la tienda sobre el límite en WooCommerce, luego Status en wp-admin: el informe de Estado del Sistema (System Status) muestra el límite de memoria de PHP que puede ver, lo cual es una buena forma de confirmar que su cambio en KPanel realmente se aplicó.
Suba a 512M si utiliza alguno de los siguientes:
- Productos variables con docenas de variaciones cada uno.
- WooCommerce Subscriptions o una extensión de reservas.
- Dos o más plugins de pasarela de pago activos a la vez.
- Una sincronización de inventario o contabilidad que se ejecuta en segundo plano.
Las páginas de administración de WooCommerce lentas o que agotan el tiempo de espera suelen deberse a una combinación de memoria y tiempo de ejecución. Suba Tiempo máximo de ejecución a 120 segundos al mismo tiempo, y considere las opciones de caché en Configuración de WooCommerce.
Revise También Su Versión de PHP
Si los errores de memoria comenzaron justo después de un cambio de PHP, la versión misma puede estar involucrada: un plugin antiguo puede tener fugas importantes en un entorno de ejecución más nuevo. La tarjeta Versión de PHP en la parte superior de la misma pestaña muestra lo que el sitio está ejecutando y permite cambiar entre PHP 8.4, 8.3, 8.2 y 8.1.
Cambiar de versión reinicia el grupo de PHP del sitio, así que espere unos segundos de inactividad. Los detalles completos están en Cambiar Su Versión de PHP.
Cuando Más Memoria No Lo Soluciona
Si aumenta el límite dos veces sin ninguna mejora, significa que algo está consumiendo memoria que no debería. Trabaje en este orden:
- Haga una copia de seguridad. Cómo Hacer una Copia de Seguridad primero, siempre.
- Encuentre el plugin. Desactive los plugins por mitades en lugar de uno a uno: desactive la mitad, vuelva a probar y luego divida la mitad que siga fallando. También puede usar Plugin safe mode en la pestaña WordPress, luego Plugins, que desactiva todos los plugins a la vez sin eliminar los datos de ninguno.
- Pruebe el tema. Cambie temporalmente a un tema predeterminado de WordPress. Un tema que ejecuta consultas pesadas en cada carga de página produce exactamente este patrón.
- Observe la operación, no el sitio. Si solo fallan las importaciones, el problema es el tiempo de ejecución y el tamaño del lote, no la memoria. Importe en fragmentos más pequeños.
- Lea el registro. El Registro de errores de PHP en la pestaña PHP indica el archivo y la línea donde se agotó la memoria, lo cual normalmente identifica el plugin de inmediato.
Si sigue sin resolverlo después de probar con 512M y una prueba limpia de plugins, envíe un correo electrónico a support@kapsulehost.com con el dominio del sitio, la línea exacta del error fatal y qué estaba haciendo cuando ocurrió.