Como resolver o erro de restrição open_basedir

Criar um ambiente de Staging para o teu site WordPress permite-te testar alterações, atualizações e novas funcionalidades sem arriscar a estabilidade do site em produção. O WP STAGING é um Plugin popular que facilita isto, permitindo aos utilizadores criar um site de Staging numa subdiretoria da sua instalação WordPress.

Durante este processo podes deparar-te com um erro de restrição open_basedir, que impede a criação do site de Staging na diretoria raiz do WordPress. Este erro está relacionado com uma diretiva de segurança na configuração do PHP que limita os ficheiros que o PHP pode aceder a uma diretoria específica e às suas subdiretorias. Este artigo vai guiar-te através dos passos para resolver este problema e criar o teu site de Staging com sucesso.

Nota: Se tentares criar um site de Staging com o WP STAGING | PRO e receberes este erro ao tentar criar um site de Staging predefinido, podes usar a definição avançada para criar o site de Staging numa subpasta de ‘wp-content’. Depois disso podes parar de ler aqui.

Compreender a restrição open_basedir

A diretiva open_basedir é uma medida de segurança implementada no ficheiro php.ini que restringe o acesso a ficheiros do PHP a diretorias especificadas. Quando o WP STAGING tenta criar um site de Staging numa diretoria que não está incluída no caminho open_basedir, despoleta o erro de restrição.

Como resolver o erro de restrição open_basedir

Para resolveres o erro de restrição open_basedir e criares com sucesso um site de Staging com o WP STAGING, segue estes passos:

Passo 1: localizar o teu ficheiro php.ini

O ficheiro php.ini é o ficheiro de configuração do PHP. A sua localização pode variar consoante o teu ambiente de Hosting. Localizações comuns incluem a diretoria raiz da tua conta de Hosting ou dentro de uma diretoria específica para versões do PHP. Pode ser necessário consultares a documentação ou o suporte do teu fornecedor de Hosting para encontrares a localização exata.

Passo 2: modificar a diretiva open_basedir

Depois de localizares o ficheiro php.ini, tens de o editar para incluir a diretoria onde queres criar o site de Staging. Abre o php.ini num editor de texto e encontra a linha que começa por open_basedir. Vais querer adicionar o caminho completo da tua diretoria raiz do WordPress (e respetivas subdiretorias) à lista existente. Separa múltiplos caminhos com dois pontos : em Linux ou ponto e vírgula ; em Windows.

Por exemplo, se o teu WordPress está instalado em /var/www/html/wordpress e a linha de configuração open_basedir no php.ini atualmente é:

ShellScript
open_basedir = "/var/www/html/"

Precisas de a modificar para incluir a diretoria do WordPress:

ShellScript
open_basedir = "/var/www/html/:/var/www/html/wordpress/"

Passo 3: reiniciar o teu servidor web

Depois de guardares as alterações ao ficheiro php.ini, precisas de reiniciar o servidor web para as alterações terem efeito. O processo de reiniciar o servidor varia consoante o teu ambiente de Hosting e o software de servidor que estás a usar. Servidores web comuns incluem Apache e Nginx. Usa o painel de controlo do teu Hosting ou consulta a documentação do teu fornecedor de Hosting para orientações sobre como reiniciar o servidor.

Passo 4: voltar a tentar criar o site de Staging

Uma vez reiniciado o servidor web, tenta criar novamente o site de Staging com o WP STAGING. O erro de restrição open_basedir deve agora estar resolvido, permitindo que o processo de criação prossiga sem problemas.

Conclusão

A restrição open_basedir é uma funcionalidade de segurança que, embora importante, pode por vezes interferir com operações legítimas como a criação de um ambiente de Staging para o teu site WordPress. Ao modificares cuidadosamente o ficheiro php.ini e ao garantires que o servidor web reconhece estas alterações, podes ultrapassar este obstáculo. Faz sempre um Backup do ficheiro php.ini antes de fazer alterações e consulta o teu fornecedor de Hosting se tiveres dúvidas sobre fazer estas modificações por ti próprio. Esta abordagem não só resolve o problema imediato como mantém a integridade da segurança do ambiente do servidor.

Updated on May 23, 2026

Rene Hermenau

Autor: Rene Hermenau

About the author: René Hermenau is the founder of WP STAGING. He works on WordPress backups, staging, migrations, database handling, and safe deployment workflows.