O arquivo index.php é um dos mais importantes de qualquer site feito em PHP — incluindo praticamente todo site WordPress. Ele funciona como a “porta de entrada” do site: é o primeiro arquivo que o servidor procura e executa quando alguém acessa uma pasta. Neste guia, você vai entender o que é o index.php, para que ele serve, a diferença entre index.php e index.html, a ordem de prioridade que o servidor segue, e o papel especial que ele tem no WordPress.
O index.php é o arquivo que o servidor carrega por padrão ao acessar um site ou pasta, quando o conteúdo é gerado com PHP. É o ponto de entrada de sites dinâmicos e o arquivo central de qualquer tema WordPress. Se ele estiver ausente ou corrompido, o site pode não carregar.
O que é o arquivo index.php?
O index.php é um arquivo escrito em PHP (uma linguagem de programação executada no servidor) que serve como página de entrada padrão de um site ou de um diretório. Quando alguém acessa o seu domínio (como seusite.com.br) ou uma pasta dele, o servidor procura automaticamente por um arquivo de índice para exibir — e o index.php é um dos principais candidatos.
A diferença em relação a uma página comum é que, por ser PHP, o index.php é processado pelo servidor antes de ser enviado ao navegador. Isso permite que ele gere conteúdo dinâmico: em vez de mostrar sempre a mesma coisa (como um HTML estático), ele pode montar a página na hora, consultar um banco de dados, carregar outros arquivos e decidir o que exibir. É por isso que praticamente todos os sistemas de gerenciamento de conteúdo (CMS) — WordPress, Magento, Joomla, Drupal — usam o index.php como base.
Para que serve o index.php?
O index.php cumpre alguns papéis centrais:
- Ponto de entrada do site. É o primeiro arquivo carregado quando alguém acessa o domínio ou uma pasta — a porta de entrada do site.
- Geração de conteúdo dinâmico. Por ser PHP, monta páginas na hora, consultando banco de dados e carregando outros componentes (algo que um HTML estático não faz).
- Organização por diretórios. A maioria das pastas de um site em PHP tem seu próprio index.php, definindo o que aparece ao acessar aquele diretório.
- Segurança. Um index.php vazio numa pasta impede que visitantes vejam a listagem dos arquivos dela (o famoso “Index of /”), protegendo a estrutura do site.
É comum encontrar arquivos index.php (ou index.html) vazios dentro de pastas que não deveriam exibir nada — como as de plugins e uploads. O motivo é proteção: sem um arquivo de índice, alguns servidores exibem a lista de todos os arquivos da pasta para qualquer visitante (o “Index of /”), revelando a estrutura do site a possíveis invasores. Um index.php vazio impede isso, devolvendo uma página em branco em vez da listagem. Por isso, não estranhe nem apague esses arquivos vazios — eles têm uma função.
Como é um arquivo index.php por dentro?
Um index.php pode ser tão simples quanto uma linha ou tão complexo quanto um sistema inteiro. No exemplo mais básico, ele apenas exibe um texto:
<?php
echo "Olá, mundo! Esta página foi gerada pelo index.php.";
?>A diferença para um HTML comum é que o trecho entre <?php e ?> é executado pelo servidor — você pode fazer cálculos, consultar um banco de dados ou carregar outros arquivos ali dentro, antes de a página chegar ao navegador.
No WordPress, o index.php da raiz é curto e tem uma função muito específica: carregar o restante do sistema. Se você precisar recriá-lo (por exemplo, após uma corrupção), este é o conteúdo padrão dele:
<?php
/**
* Front to the WordPress application.
*
* @package WordPress
*/
define( 'WP_USE_THEMES', true );
require __DIR__ . '/wp-blog-header.php';
Repare que ele “não faz nada” sozinho: apenas define que o tema deve ser usado (WP_USE_THEMES) e carrega o wp-blog-header.php, que é quem inicia todo o WordPress. É por isso que esse arquivo raramente deve ser alterado — mas, se ele sumir ou for corrompido, recriá-lo com o código acima costuma restaurar o site.
Como criar ou editar um arquivo index.php
Criar ou editar um index.php é simples e pode ser feito de duas formas:
Pelo Gerenciador de Arquivos da hospedagem:
- Acesse o painel da sua hospedagem (cPanel, DirectAdmin) e abra o Gerenciador de Arquivos.
- Navegue até a pasta raiz do site — normalmente a
public_html(ou a pasta do diretório onde o arquivo deve ficar). - Clique em Novo arquivo, nomeie como
index.php, e edite-o pelo próprio painel para inserir o código.
Por FTP (FileZilla, por exemplo):
- Crie o arquivo
index.phpno seu computador, em um editor de texto simples. - Conecte-se ao servidor via FTP e envie o arquivo para a pasta
public_html(ou o diretório desejado).
Em ambos os casos, o importante é que o arquivo se chame exatamente index.php e esteja no diretório correto — assim o servidor o reconhecerá como a página de entrada daquela pasta. Depois de criar, basta acessar o endereço no navegador para testar.
index.php vs index.html: qual a diferença?
Essa é a dúvida mais comum — e a distinção é importante:
Em resumo: use index.html para páginas estáticas e simples; o index.php é necessário quando o site precisa de conteúdo dinâmico (o caso do WordPress e da maioria dos sites atuais). Se você quer entender melhor o arquivo estático, veja nosso guia sobre como criar um arquivo index.html.
Qual tem prioridade: index.php ou index.html?
Se uma mesma pasta tiver os dois arquivos, qual o servidor mostra? Isso depende da configuração do servidor (a diretiva DirectoryIndex, no Apache). Na maioria das hospedagens, a ordem padrão dá prioridade ao index.php sobre o index.html — ou seja, se os dois existirem, o index.php é exibido primeiro. Essa ordem pode ser alterada no arquivo .htaccess, caso você precise que o index.html tenha preferência.
O index.php no WordPress
É no WordPress que o index.php ganha um papel ainda mais central — e aqui existem, na verdade, dois arquivos index.php diferentes:
1. O index.php da raiz (que “liga” o WordPress)
Na pasta raiz da instalação do WordPress existe um index.php que é o ponto de entrada de todo o site. Ele é curto, mas essencial: sua função é carregar o wp-blog-header.php, que por sua vez inicia todo o WordPress e manda exibir o tema. Se esse arquivo for apagado ou corrompido, o site carrega uma tela branca — por isso ele nunca deve ser modificado sem necessidade.
2. O index.php do tema (o “arquivo curinga”)
Dentro da pasta do tema, o index.php tem um papel especial na chamada hierarquia de templates do WordPress. Ele é o arquivo de último recurso (fallback): quando o WordPress precisa exibir uma página e não encontra um template mais específico, ele recorre ao index.php do tema.
Por exemplo: ao exibir uma categoria, o WordPress procura primeiro por category.php; se não existir, tenta archive.php; se também não existir, usa o index.php. O mesmo vale para posts (single.php), páginas (page.php) e a busca (search.php) — o index.php é o “tapa-buraco” que assume quando o arquivo ideal não está presente. É justamente por isso que o index.php e o style.css são os únicos dois arquivos obrigatórios para um tema WordPress funcionar.
Para visualizar como o index.php atua como último recurso, veja a ordem que o WordPress segue ao exibir uma página de categoria (o mesmo princípio vale para posts, páginas e busca):
O WordPress usa o primeiro arquivo que encontrar, da esquerda para a direita. O index.php (à direita) é o último recurso — sempre existe, e assume quando nenhum template mais específico está presente.
Vale uma distinção que confunde quem desenvolve temas: o index.php não é necessariamente quem exibe a página inicial. O WordPress dá prioridade a arquivos mais específicos para a home — o front-page.php (usado quando há uma página inicial definida em Configurações → Leitura) e o home.php (a listagem de posts recentes). O index.php só assume a home quando nenhum desses existe. Ou seja: index.php é o curinga geral; front-page.php e home.php são especialistas na página inicial.
O index.php da raiz do WordPress raramente deve ser tocado. Se o seu site apresentar uma tela branca após uma edição, o arquivo pode ter sido corrompido. Sempre faça um backup antes de editar qualquer arquivo do núcleo, e prefira usar um tema-filho para personalizações.
O que fazer se o index.php causar problemas
Alguns problemas comuns ligados ao index.php e como agir:
- Tela branca (White Screen of Death). Costuma indicar um index.php corrompido ou um erro de PHP. Restaure um backup ou substitua o arquivo por uma versão limpa.
- Aparece o “Index of /” em vez do site. Significa que o servidor não encontrou um index.php (nem index.html) na pasta. Verifique se o arquivo está no diretório correto (a raiz costuma ser a
public_html). - O site baixa o arquivo em vez de exibir. Sinal de que o PHP não está sendo processado no servidor. Nesse caso, é uma questão de configuração da hospedagem — vale contatar o suporte.
Sites em PHP e WordPress precisam de um servidor configurado corretamente para processar o index.php. A hospedagem da Homehost já vem otimizada para PHP e WordPress, com suporte em português para ajudar quando algo dá errado.
Conhecer a hospedagem WordPressPerguntas frequentes
O que é o arquivo index.php?
É um arquivo escrito em PHP que serve como página de entrada padrão de um site ou pasta. Por ser processado pelo servidor, ele pode gerar conteúdo dinâmico — consultando banco de dados e carregando outros componentes — antes de enviar a página ao navegador. É a base de sites em PHP e do WordPress.
Qual a diferença entre index.php e index.html?
O index.html é estático: entrega um conteúdo fixo direto ao navegador. O index.php é dinâmico: é executado pelo servidor, pode acessar banco de dados e gerar a página na hora. Use index.html para páginas simples e index.php para sites dinâmicos, como o WordPress.
Qual tem prioridade, index.php ou index.html?
Depende da configuração do servidor (a diretiva DirectoryIndex). Na maioria das hospedagens, o index.php tem prioridade sobre o index.html quando os dois existem na mesma pasta. Essa ordem pode ser alterada pelo arquivo .htaccess.
Para que serve o index.php no WordPress?
Existem dois: o index.php da raiz, que inicia todo o WordPress (e nunca deve ser apagado), e o index.php do tema, que é o arquivo de último recurso da hierarquia de templates — usado sempre que o WordPress não encontra um template mais específico. Ele e o style.css são os únicos arquivos obrigatórios de um tema.
Meu site abre uma tela branca. É o index.php?
Pode ser. Uma tela branca costuma indicar um index.php corrompido ou um erro de PHP. Restaure um backup do arquivo ou substitua por uma versão limpa. Se o problema persistir, contate o suporte da sua hospedagem.
Veja também
- Como criar um arquivo index.html
- O que é o WordPress
- O que é um servidor web
- Arquivo .htaccess: aprenda tudo
Conclusão
O index.php é uma peça central de qualquer site em PHP: a porta de entrada que o servidor carrega e executa para montar a página. Diferente do index.html (estático), ele gera conteúdo dinâmico — e é por isso que o WordPress e a maioria dos CMS dependem dele. No WordPress, ele tem papel duplo: o da raiz inicia o site, e o do tema é o arquivo curinga da hierarquia de templates. Entender o index.php ajuda a diagnosticar problemas comuns (como a tela branca ou o “Index of /”) e a compreender melhor como o seu site funciona por baixo dos panos.
