====== 🌐 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
`