🌐 Solución a Error de Escritura y Permisos en DokuWiki (datadir is not accessible)

Fecha de incidencia: Septiembre 2026 Error típico: The datadir ('pages') at /home/morezane/public_html/wiki/data/pages is not found, isn't accessible or writable.

1. Causa Raíz

El problema se desencadena tras mantenimientos, parches de seguridad o actualizaciones automáticas del servidor de hosting (cPanel/CloudLinux):

Desalineación del proceso web (PHP Handler): El motor de PHP (ej. alt-php83) pasa a ejecutarse bajo el usuario genérico del servidor (nobody) mientras los archivos pertenecen al usuario de la cuenta (morezane).
Conflicto de permisos 755: Bajo permisos de seguridad estándar (755 en carpetas y 644 en archivos), el proceso de PHP en modo nobody no tiene derechos de escritura sobre las carpetas de morezane.

2. Evidencia Diagnóstica por Cambio de Permisos

El comportamiento del sitio al alternar permisos entre 777 y 755 permite diagnosticar la causa exacta sin necesidad de revisar los logs del servidor:

Permiso aplicado	Resultado en Navegador	Diagnóstico Técnico / Evidencia	Acción Correctiva
777	Funciona (carga y guarda)	Aislamiento exitoso: El código de DokuWiki es correcto, pero el proceso de PHP corre bajo un usuario genérico del servidor (`nobody`) distinto al dueño del archivo (`morezane`).	Ajustar el PHP Handler a controlador de usuario (`ea-php`) o solicitar corrección de `chown`.
755	Error `datadir is not accessible`	Desalineación de Identidad: El permiso 755 otorga escritura exclusivamente al propietario. Al fallar, evidencia que PHP no se ejecuta como el dueño del directorio.	Cambiar versión a `ea-php` en cPanel o ejecutar `chown -R usuario:usuario`.
777	Persiste el error	Bloqueo de PHP / Apache: El fallo no es del sistema de archivos, sino de una directiva interna de PHP (`open_basedir`) o ruta errónea en `conf/local.php`.	Revisar la casilla `open_basedir` en la configuración de PHP del cPanel (dejar en blanco).
755	Funciona correctamente	Alineación Perfecta: El usuario del proceso PHP coincide con el propietario de la carpeta. Entorno 100% seguro.	Estado ideal de operación.

3. Protocolo de Solución Rápida

Paso 1: Alineación del Controlador de PHP (cPanel)

1. Entrar a cPanel -> **Administrador MultiPHP** (MultiPHP Manager).
2. Seleccionar el dominio o subdominio de la wiki.
3. Cambiar el controlador de versión ''alt-php'' a la variante **''ea-php''** (ejemplo: ''ea-php83'' o ''ea-php82'').
4. Las versiones ''ea-php'' ejecutan obligatoriamente los procesos PHP bajo la identidad del usuario de cPanel (''morezane'').

Paso 2: Normalización de Propietario (chown)

Si la propiedad de los archivos fue alterada por el servidor, solicitar al soporte del hosting (o ejecutar mediante terminal/SSH): ` chown -R morezane:morezane /home/morezane/public_html/wiki/data `

Paso 3: Restablecer Permisos Estándar

Evitar el uso permanente de permisos 777. Establecer desde el Administrador de Archivos de cPanel:

Carpetas: 0755
Archivos: 0644

Paso 4: Limpieza de Caché y Archivos Temporales

Si surgen advertencias en bloques rosados referentes a data/cache/ o data/tmp/captcha/:

1. Navegar a ''/public_html/wiki/data/cache/''.
2. Eliminar las carpetas temporales con nombres de un solo carácter (de la ''0'' a la ''f''). DokuWiki las regenerará automáticamente.
3. Asegurar la existencia de las subcarpetas ''data/tmp/'' y ''data/log/error/''.

Paso 5: Tiempo de Propagación

Tras modificar la versión de PHP en cPanel o aplicar cambios de propiedad en el servidor, esperar de 3 a 10 minutos. Los demonios de PHP-FPM o LiteSpeed requieren ese intervalo para reiniciar los worker processes en memoria.
Recargar el sitio web forzando la caché del navegador con Ctrl + F5 (o Cmd + Shift + R).

4. Resguardo de Seguridad

Confirmar que el archivo /public_html/wiki/data/.htaccess contenga la siguiente regla para evitar la lectura pública de los archivos de texto por URL: ` Require all denied `