1 min. de lectura (aproximado)

Cómo definir un fichero index de un directorio en Apache

Cuando creas un sitio web, el archivo principal que Apache sirve automáticamente al acceder a un directorio se denomina fichero índice. Por convención suele llamarse "index.html", "index.php", "index.htm" u otras variantes según el lenguaje o framework utilizado.
Apache permite personalizar qué archivos se consideran índices y en qué orden se buscan. La forma más habitual y flexible de hacerlo en un entorno compartido o sin acceso a la configuración global del servidor es mediante el archivo ".htaccess".

Configuración básica con DirectoryIndex

Crear o editar el archivo ".htaccess" en el directorio raíz de tu sitio, o en el subdirectorio que se desees, y añadir la siguiente línea:

DirectoryIndex index.html index.php index.htm

¿Cómo funciona?

Apache busca los ficheros en el orden en que los escribes. En el ejemplo anterior:
  1. Primero intenta servir "index.html"
  2. Si no existe, prueba con "index.php"
  3. Si tampoco existe, busca "index.htm"
  4. Si ninguno de los tres está presente, genera un error 404 (Not Found), siempre que el listado de directorios esté desactivado.

Ejemplo más completo y recomendadoa

DirectoryIndex index.php index.html index.htm default.php home.php
Se pueden incluir tantos nombres como se necesite. Es habitual priorizar "index.php" en proyectos PHP modernos.

Requisitos importantes

El módulo "mod_dir" debe estar habilitado, normalmente lo está por defecto.
El archivo ".htaccess" debe tener permisos de lectura para el usuario de Apache.
La directiva "AllowOverride" debe permitir al menos Indexes o All en el directorio correspondiente. Ejemplo:

Comportamiento cuando no hay fichero índice

Si no existe ningún archivo de los definidos en "DirectoryIndex" y se tiene activado el listado de directorios:

Options +Indexes/code>
Apache mostrará el listado del contenido del directorio. Por seguridad, en producción se recomienda desactivarlo:

Options -Indexes