Guía Completa de Gestión de Proyectos PHP en aaPanel

Esta guía detalla la gestión de proyectos PHP en aaPanel, un panel de control de hosting que soporta Nginx, Apache y OpenLiteSpeed. Se recomienda usar Cron para realizar copias de seguridad automáticas del sitio web diariamente. La información se basa en la documentación oficial de aaPanel para la gestión de sitios PHP.

Visión General de Proyectos PHP

En esta sección, puedes gestionar proyectos PHP, con soporte para Nginx y Apache OpenLiteSpeed.

Funciones Principales

Función	Descripción
Agregar sitio	Crea un nuevo sitio web. Se pueden crear en lotes.
Página predeterminada	Muestra la página predeterminada del nuevo sitio. Haz clic para configurar la página predeterminada.
Sitio web predeterminado	Configura el sitio predeterminado. Todos los nombres de dominio e IPs no vinculados se redirigen al sitio predeterminado. Esto previene eficazmente el análisis malicioso.
PHP CLI	Configura la versión de PHP usada al ejecutar PHP desde la línea de comandos.
Protección HTTPS	Al activarla, resuelve el problema de cruce de sitios HTTPS.
Configuraciones globales	Configura el encabezado de solicitud para mostrar la IP real del usuario en el sitio.

Columnas de la Lista de Sitios

Columna	Descripción
Nombre del sitio	El nombre de dominio vinculado al sitio. Haz clic en el nombre del sitio actual para configurar y modificar el sitio actual.
Estado	Muestra el estado de ejecución del sitio web actual. Haz clic en el estado de ejecución del sitio actual para desactivarlo.
Copia de seguridad	Muestra el estado de copia de seguridad del sitio actual. Haz clic en el estado de copia de seguridad del sitio actual para ver, restaurar, descargar y respaldar los archivos del sitio actual.
Raíz de documentos	Muestra la ruta del directorio del sitio actual. Haz clic en el directorio del sitio actual para saltar directamente a la gestión de archivos en ese directorio.
Cuota	Muestra la cuota del sitio actual. Haz clic para modificar la cuota del sitio actual (solo soporta el sistema de archivos XFS).
Fecha de expiración	Muestra el tiempo efectivo del sitio actual. Haz clic para establecer la fecha de expiración del sitio actual (predeterminado: permanente).
Nota	La nota se usa para registrar información del sitio actual, como el propósito del sitio.
PHP	Muestra la versión de PHP del sitio actual. Haz clic para cambiar la versión de PHP del sitio actual.
SSL	Muestra el estado SSL del sitio actual. Haz clic para vincular un certificado SSL al sitio actual.
Ataque	Escanea el registro del sitio web para mostrar el estado de ataques al sitio actual. Haz clic para ver detalles de escaneo de ataques.
Estadísticas	Usa Website Statistics-v2 para ver el tráfico, conexiones, etc., del sitio actual.
WAF	Configura la configuración WAF del sitio actual.
Conf	Configura el sitio actual, como: Administrador de dominios, Directorio del sitio, Límite de acceso, Control de tráfico, Reescritura de URL, Índices predeterminados, Redirección, Proxy inverso, Protección contra hotlinking, Registro de acceso, Registro de errores, etc.
Eliminar	Elimina el sitio actual. Después de la eliminación, el directorio del sitio se moverá a la papelera de reciclaje en la interfaz de Archivos.

Nota: Al hacer clic en Nombre del sitio o Conf, puedes modificar la configuración del sitio, SSL, registros, etc.

Administrador de Dominios

Agrega o elimina dominios/IP al sitio actual.
Vinculación de subdirectorio: Vincula a un directorio especificado bajo el sitio usando un subdominio nuevo.

Directorio del Sitio

Directorio del sitio: Configura el directorio de despliegue del sitio web actual.
Directorio de ejecución: Especifica un subdirectorio como directorio de ejecución, como en Laravel.
Protección anti-ataque XSS: Protección contra ataques cross-site (open_basedir). Previene intrusiones de hackers a través de otros directorios de sitios, es decir, agrega y elimina archivos .user.ini.
Registro de acceso de escritura: Activa/desactiva el registro del sitio actual y agrega registros de acceso.
Acceso con contraseña: Activa/desactiva el acceso con cuenta y contraseña a todo el sitio actual.

Límite de Acceso

Límite de acceso: Especifica que el directorio del sitio requiere cuenta y contraseña.
Denegar acceso: Desactiva el acceso a archivos en el directorio especificado del sitio.

Control de Tráfico

Limita el control de tráfico para el sitio actual.

Reescritura de URL

Crea o usa una plantilla existente. A través de la conversión, puedes convertir páginas web dinámicas en páginas estáticas para mejorar la amigabilidad con los motores de búsqueda.

Si el servicio WEB es Apache, usará el archivo .htaccess en el directorio del sitio por defecto.
Si el servicio WEB es Nginx, elige una plantilla existente o consulta la documentación del programa del sitio para la configuración.
Si reemplazas Apache con Nginx, debes restablecer la reescritura de URL a la configuración de Nginx.

Índices Predeterminados

Configura la página de inicio predeterminada del sitio web actual, es decir, el archivo de índice del sitio.

Configuración (Conf)

Ve y modifica el archivo de configuración del sitio actual.

️ Nota: Si hay un comentario #, no lo elimines ni lo modifiques.

SSL

Configura el acceso encriptado al sitio web, es decir, usa HTTPS para acceder al sitio web.

1. Certificados actuales y otros

Ve, desactiva, guarda (activa) el certificado SSL del sitio actual, o pega el contenido del certificado SSL para configurarlo.

2. Certificado comercial

Certificados comerciales de aaPanel en cooperación con proveedores SSL.

Si compraste un Certificado Comercial, consulta este tutorial sobre cómo verificarlo: Tutorial de Certificado Comercial.

3. Let's Encrypt

Verificación por archivo

Los servidores de Let's Encrypt verifican la propiedad del dominio accediendo a los archivos de este sitio web.

Si ocurre un error, soluciona primero y luego verifica. Múltiples errores limitarán las Límites de Tasa de Let's Encrypt.
Si falla la verificación, soluciona según los indicios:
- Tal vez la resolución DNS no ha surtido efecto y no se ha agregado resolución.
- Let's Encrypt no puede acceder a tu sitio. Verifica redirecciones y proxies. Intenta acceder y ve si se muestra normal. Aplica de nuevo después de que sea normal.
Si la verificación por archivo no está disponible, usa verificación DNS.
Si aparecen restricciones, usa SSL de sitios de terceros.

Verificación DNS (soporte para comodines)

Los servidores de Let's Encrypt verifican la propiedad del dominio analizando registros DNS. Si agregas registros DNS manualmente, no se renovarán automáticamente.

Si el dominio está en CloudFlare, puedes usar la API DNS; de lo contrario, agrega manualmente el registro TXT según los indicios.
Agregar un registro TXT toma tiempo para surtir efecto. Durante este período, no cierres la ventana de registro TXT indicada por aaPanel.
Agregar manualmente un registro TXT no renovará automáticamente el certificado SSL de Let's Encrypt.

Haz clic para ver Cómo solicitar un certificado de nombre de dominio pan.

4. Titular del certificado

Los certificados SSL configurados se guardarán aquí.

Versión de PHP

Configura la versión de PHP del sitio actual, según la versión requerida por el sitio actual. Si necesitas agregar una versión de PHP, puedes instalarla en la Tienda de Aplicaciones.

Composer

Composer es el administrador de paquetes de dependencias principal para PHP. Si tu proyecto usa Composer para gestionar paquetes de dependencias, puedes actualizar o instalar dependencias aquí.

Redirección

Configura el dominio o directorio especificado del sitio actual para un salto 301/302 a la dirección especificada.

Proxy Inverso

Configura el proxy del sitio web actual para acceder a recursos de otros sitios.

Protección contra Hotlinking

Solo el dominio especificado puede acceder a los recursos del sitio actual. Si no es el dominio especificado, se devuelve un error.

Registros de Respuesta

Registro de acceso: Registro de acceso del sitio actual.
Registro de error: Registro de error para el sitio actual. Si hay un error en el sitio web, puedes ver este registro.
Análisis de seguridad de registros: Escanea archivos de registro del sitio actual en busca de solicitudes que contengan tipos de ataques (tipos incluyen: xss, sql, san, php).

Agregar Sitio: Crear Sitio

Función	Descripción
Resolver dominio	Elige Agregar Registro Manual o Agregar Registro Automático. Nota: Agregar Registro Automático requiere agregar la API DNS correspondiente en Dominios y tener un certificado SSL válido para el dominio para funcionar correctamente.
Nombre de dominio	Rellena el nombre de dominio y puerto a vincular (el subdominio www no se crea automáticamente).
Descripción	Describe el rol del sitio web.
Ruta del sitio web	La ruta del archivo del sitio web actual. Puedes elegir el punto de creación tú mismo; trata de usar la ruta predeterminada `/www/wwwroot/` para facilitar la gestión.
FTP	Al crear un sitio web, puedes elegir si crear también una cuenta FTP al crear el sitio web.
Base de datos	Al crear un sitio web, puedes elegir si crear una base de datos MySQL al mismo tiempo que se crea el sitio web.
Versión de PHP	Elige la versión de PHP que necesita tu sitio web. Para obtener más versiones de PHP, puedes instalarlas en la Tienda de Aplicaciones del panel.
Categoría del sitio	Se usa para clasificar sitios web y facilitar la gestión.

Agregar Sitio: Crear para Git

Función	Descripción
Resolver dominio	Elige Agregar Registro Manual o Agregar Registro Automático. Nota: Agregar Registro Automático requiere agregar la API DNS correspondiente en Dominios y tener un certificado SSL válido para el dominio para funcionar correctamente.
Nombre de dominio	Rellena el nombre de dominio y puerto a vincular (el subdominio www no se crea automáticamente).
Ruta del sitio web	La ruta del archivo del sitio web actual. Puedes elegir el punto de creación tú mismo; trata de usar la ruta predeterminada `/www/wwwroot/` para facilitar la gestión.
Versión de PHP	Elige la versión de PHP que necesita tu sitio web. Para obtener más versiones de PHP, puedes instalarlas en la Tienda de Aplicaciones del panel.
Proveedor Git	Copia y agrega la clave SSH mostrada al repositorio Git, e ingresa el Repositorio y Rama del repositorio Git para clonar automáticamente la rama y crear el sitio. Ver Cómo agregar un sitio de repositorio Git.

Agregar Sitio: Crear en Lote

Crea sitios en lotes.

Formato de lote: Domain|Document Root|FTP|Database|PHP version

Ejemplo:

aapanel.com|/www/wwwroot/aapanel.com|1|1|83
aapanel.store|/www/wwwroot/aapanel.store|1|1|83

Agregar Sitio: Desplegar WordPress

️ ADVERTENCIA: Obsoleto. Despliegue antiguo de WordPress. Por favor, usa WP Toolkit.

Página Predeterminada

La página predeterminada para sitios recién creados. Los sitios existentes no se modificarán.

Función	Descripción
Página predeterminada	La página de提示 generada por defecto al crear el sitio.
Página 404	La página de error devuelta por el servidor con código de estado 404.
Página de dominio no vinculado	Página en blanco de Nginx / Página en blanco de Apache: El servidor no puede encontrar el sitio correspondiente, la página de error提示.
Página de detención	Una página usada para retroalimentar información de detención del sitio. Si no hay requisitos relacionados, no la modifiques.

Sitio Web Predeterminado

Después de configurar el sitio predeterminado, todos los nombres de dominio e IPs no vinculados se redirigen al sitio predeterminado. Esto previene eficazmente el análisis malicioso.

PHP CLI

Configura la versión de PHP usada al ejecutar PHP desde la línea de comandos. Debe restablecerse después de instalar una nueva versión de PHP.

Protección HTTPS

Configuración avanzada → Protección HTTPS

Al activarla, resuelve el problema de cruce de sitios HTTPS.

Configuraciones Globales

Configuración avanzada → Configuraciones globales

Configura el encabezado de solicitud para mostrar la IP real del usuario en el sitio.

Gestión de Programas Web

Gestiona el programa web con soporte para Nginx, Apache u OpenLiteSpeed.

Todas las Categorías

Agrega, configura y elimina categorías de sitios web.

Cómo usar categorías: Primero selecciona el sitio y luego selecciona "Establecer categoría" en la esquina inferior izquierda para configurar la categoría.

Copia de Seguridad

Ve, restaura, respalda, elimina y descarga archivos de copia de seguridad del sitio especificado.

Cuota

Ve y modifica la cuota de espacio del sitio especificado.

Fecha de Expiración

Ve y modifica la fecha de expiración del sitio especificado.

Cuadro de Búsqueda

Busca rápidamente sitios web a través de Dominio o Notas.

Operaciones en Lote

Se puede usar al seleccionar uno o más sitios web.

Función	Descripción
Activar sitio web	Activa sitios en lotes.
Desactivar sitio web	Detiene sitios en lotes.
Copia de seguridad del sitio web	Respaldar sitios en lotes.
Establecer fecha de expiración	Establece el tiempo de expiración del sitio en lotes.
Establecer versión de PHP	Establece la versión de PHP del sitio en lotes.
Establecer categoría	Establece categorías de sitios en lotes.
Eliminar sitio web	Elimina sitios en lotes. Por favor, respalda antes de eliminar.

Ejemplo de Uso: Desplegar un Sitio phpBB con Subdominio www.testphpbb.com

En el sitio del proveedor de nombres de dominio, apunta la IP del registro A de www.testphpbb.com a la IP del servidor de aaPanel, como 1.2.3.4.
Agrega el dominio www.testphpbb.com a aaPanel, crea una base de datos y registra la cuenta y contraseña de la base de datos creada.
Verifica los requisitos de software de despliegue de phpBB:
- Encuentra los requisitos de despliegue en la Documentación Oficial. Este ejemplo usa PHP 8.3, MySQL 5.7.
- Si el software correspondiente no está instalado en aaPanel, instálalo en la Tienda de Aplicaciones.
Descarga el paquete de phpBB:
- Descarga directamente desde la interfaz de Archivos de aaPanel usando el enlace del paquete de software.
- O descarga desde el sitio oficial a tu computadora local y luego súbelo a /www/wwwroot/.
Selecciona phpBB-3.3.13.zip y descomprime el archivo en /www/wwwroot/www.testphpbb.com.
Encuentra el directorio www.testphpbb.com, haz clic en él para entrar y ver la estructura de directorios descomprimida.
Después de la descompresión, el directorio del programa del sitio está bajo phpBB3, por lo que el directorio predeterminado del sitio debe modificarse a phpBB3. (El directorio del paquete de software de diferentes programas puede variar; modifícalo según la situación real).
Configura SSL para el sitio. Si no se configura SSL, solo se puede acceder usando HTTP.
Usa un navegador para visitar http://www.testphpbb.com.
Haz clic en "Instalar" e ingresa la información según los indicios:
- Ingresa información del administrador.
- Ingresa información de la base de datos (Si no has registrado la cuenta y contraseña de la base de datos, puedes verlas en la interfaz de Bases de Datos).
- Continúa siguiendo los indicios para completar la instalación hasta que termine.
Después de la instalación completa, visita de nuevo http://www.testphpbb.com. En este punto, el despliegue de phpBB se ha completado. Para más configuraciones de uso de phpBB, consulta la documentación oficial.