Guía de Instalación de Paquetes PHP PEAR en cPanel
PEAR (PHP Extension and Application Repository) es un repositorio de código PHP que permite instalar librerías reutilizables para facilitar el desarrollo web. Aunque hoy en día el estándar moderno es Composer, muchas aplicaciones y scripts heredados (legacy) aún dependen de paquetes PEAR clásicos como Mail, Net_SMTP o XML_RPC.
cPanel incluye una herramienta gráfica que facilita la descarga e instalación de estas librerías directamente en tu cuenta de hosting, sin necesidad de usar la línea de comandos.
Instalar librerías, gestionar dependencias con Composer o modificar el
php.ini puede ser limitado en un hosting compartido. Despliega tus aplicaciones sin restricciones en un Servidor VPS Linux de Alto Rendimiento con acceso Root.
Pasos para instalar un paquete PEAR
Sigue estas instrucciones actualizadas para la interfaz moderna de cPanel (Jupiter):
- Inicia sesión en tu cuenta de cPanel.
- Ve a la sección Software y haz clic en el icono Paquetes PHP PEAR.
- Paso Crítico (Rutas): Antes de instalar nada, observa el recuadro que dice "Ubicación de su(s) módulo(s) de PHP".
Verás una ruta similar a:/home/usuario/php. Copia esa ruta, la necesitarás más adelante. - Baja hasta el buscador "Buscar un Paquete de PEAR". Escribe el nombre (ejemplo:
Mail) y haz clic en Ir. - El sistema te mostrará los resultados disponibles. Haz clic en el botón verde Instalar.
- Espera a que termine el proceso. Si todo sale bien, verás un mensaje de éxito. Haz clic en Regresar.
Cómo configurar tu código PHP para usar el paquete
El error más común es instalar el paquete y que el sitio web diga "Class not found". Esto sucede porque tu script PHP no sabe dónde se instaló la librería. Debes indicarle la ruta (la que copiaste en el paso 3).
Agrega este código al inicio de tu archivo PHP:
<?php
// Agregamos la ruta de PEAR al "include_path" de PHP
// Reemplaza '/home/tousuario/php' con la ruta real que viste en cPanel
$path = '/home/tousuario/php';
set_include_path(get_include_path() . PATH_SEPARATOR . $path);
// Ahora ya puedes llamar a la librería
require_once 'Mail.php'; // Ejemplo
?>
Gestión de Paquetes Instalados
En la misma pantalla de "Paquetes PHP PEAR", verás una lista en la parte inferior con todas las librerías que has añadido. Desde allí puedes:
- Actualizar: Si hay una nueva versión disponible.
- Reinstalar: Útil si borraste archivos por error.
- Desinstalar: Para eliminar paquetes que ya no usas y liberar espacio.
- Mostrar Docs: Te lleva a la documentación oficial del paquete.
Preguntas Frecuentes
¿Debo usar PEAR o Composer para mi nuevo proyecto?
Si estás empezando un proyecto nuevo desde cero, usa Composer. PEAR es una tecnología antigua y muchos de sus paquetes ya no reciben mantenimiento. Usa el instalador de PEAR de cPanel solo si estás manteniendo scripts antiguos que lo requieran específicamente.
¿Por qué me aparece el error "Failed to open stream"?
Este error indica que PHP no encuentra el archivo de la librería. Asegúrate de haber configurado correctamente el include_path en tu código (como mostramos arriba) o en tu archivo php.ini (usando el editor MultiPHP INI en cPanel) apuntando a la carpeta /home/usuario/php.
