Aquí se explica la configuración para ejecutar Zittme en nginx. Si usas Apache, no necesitas este documento: el .htaccess de la distribución se encarga de todo.

La forma más fácil: el asistente de configuración

Zittme ofrece asistentes que generan la configuración de nginx. Usa el que te resulte más cómodo.

• Pantalla de verificación del entorno del asistente de instalación: si las URL cortas (rewrite) no están configuradas, detecta el entorno del servidor y genera una configuración a medida y los comandos para aplicarla. Solo copia y pega.
• Asistente de URL cortas en Administración > Configuración del sistema: la misma función está disponible también después de instalar.
• Script que lo aplica todo de una vez: common/scripts/setup-nginx.sh de la distribución

Si prefieres configurarlo tú, consulta lo siguiente.

Ubicación de los archivos de configuración

Ejemplo de bloque server

common/manual/server_config/zittme-nginx.conf de la distribución contiene todas las reglas. La estructura básica es la siguiente.

server {
    listen 80;
    server_name example.com;
    root /var/www/mysite;
    index index.php index.html;
    client_max_body_size 32m;

    # 여기에 zittme-nginx.conf 의 규칙(차단·rewrite)을 넣거나 include 합니다

    location / {
        try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    }
}

• root es la ruta de instalación de Zittme, y index debe incluir obligatoriamente index.php.
• client_max_body_size es el tamaño máximo de subida. Ajústalo según el tamaño de los archivos adjuntos.
• La ruta del socket de PHP-FPM cambia según el servidor. Revísala con ls /run/php/ o usa el modo por puerto (fastcgi_pass 127.0.0.1:9000;).

Cuidado con el orden de las reglas

Las reglas rewrite de Zittme ya incluyen el bloque location / { try_files ... }. Si pones ese mismo bloque duplicado en la configuración del sitio, se produce un error. Coloca las reglas de bloqueo (los bloques location) antes del bloque que procesa PHP.

Aplicar y comprobar

nginx -t
systemctl reload nginx

nginx -t debe mostrar ok. Si hay algún problema, revisa /var/log/nginx/error.log.

Reglas de bloqueo de seguridad

zittme-nginx.conf incluye reglas que impiden el acceso web directo a los archivos de plantillas, configuración y caché. Aunque armes tu propia configuración, incluye siempre estas reglas de bloqueo. Si las omites, los originales de las plantillas y los archivos internos pueden quedar expuestos.