Base de Conhecimento

8.22 Como configurar o open_basedir no Select PHP Version

A diretiva open_basedir serve para restringir os diretórios que o PHP pode acessar por leitura ou gravação dentro da hospedagem.

Na prática, essa opção ajuda a limitar o alcance dos scripts PHP, impedindo que uma aplicação acesse caminhos fora das pastas autorizadas.

Como acessar o cPanel

Para ajustar essa diretiva, acesse o cPanel pela URL direta, pela porta 2083 ou pela área do cliente MyWay. Depois, vá em Software > Select PHP Version > Options.

Essa é uma configuração mais técnica. Antes de alterar, é importante ter certeza de quais diretórios a aplicação realmente precisa acessar.

Como configurar o open_basedir no Select PHP Version

Entendendo o que essa opção faz

O open_basedir funciona como uma limitação de caminhos permitidos para o PHP.

Isso significa que, quando está configurado, os scripts normalmente só conseguem abrir arquivos dentro dos diretórios autorizados nessa diretiva.

Tradução útil:

open_basedir = restrição de caminhos permitidos para acesso de arquivos

Esse recurso é útil para endurecer o ambiente, mas também pode bloquear aplicações que dependem de bibliotecas, sessões, uploads, caches ou arquivos em diretórios não incluídos na configuração.

Quando essa configuração é usada

para restringir o PHP a uma pasta específica do site
para limitar o acesso do script apenas ao diretório da aplicação
para reduzir risco de leitura de arquivos fora do local previsto
para ambientes personalizados ou mais controlados

Se a aplicação precisar acessar arquivos temporários, sessões, cache, bibliotecas compartilhadas ou diretórios adicionais, todos esses caminhos precisarão estar contemplados corretamente.

Passo 1 – Localizar a diretiva open_basedir

Na guia Options, procure pelo campo open_basedir.

Dependendo do ambiente, o campo poderá estar vazio, preenchido ou com valor padrão já definido.

Passo 2 – Informar os diretórios permitidos

Defina os caminhos que o PHP poderá acessar.

Em geral, é preciso incluir a pasta principal do site e qualquer outro caminho necessário ao funcionamento da aplicação.

Exemplos de uso conceitual:

diretório principal do site
pasta temporária usada pela aplicação
diretório de sessões, se estiver separado
pasta de cache ou arquivos compartilhados, quando existir

Quanto mais restrito for o conjunto de caminhos, maior tende a ser o controle. Porém, quanto mais restrito demais, maior o risco de o site parar de funcionar por não conseguir acessar arquivos que realmente precisa.

Passo 3 – Salvar e testar o funcionamento real do site

Depois de aplicar a alteração:

abra páginas públicas do site
teste o painel administrativo
confira upload de arquivos
teste geração de cache, imagens, relatórios ou qualquer função mais sensível

Se tudo continuar funcionando corretamente, a diretiva foi ajustada de forma compatível com a aplicação.

Problemas comuns após configurar open_basedir

erro ao incluir arquivos
falha ao criar cache ou sessão
plugin ou framework não encontra bibliotecas
mensagem de acesso negado a caminho fora da base permitida

Quando isso acontecer, normalmente significa que a aplicação está tentando acessar um diretório que não foi incluído na diretiva.

Resultado esperado

Ao final do processo, o PHP ficará restrito aos diretórios definidos no open_basedir, reduzindo o alcance dos scripts e tornando o ambiente mais controlado.

Para configurar o open_basedir:

1. Acesse Select PHP Version
2. Vá em Options
3. Localize open_basedir
4. Informe os diretórios realmente necessários para a aplicação
5. Salve e teste o site por completo

Na prática, essa diretiva é usada para restringir o acesso do PHP a caminhos específicos da hospedagem.

Essa é uma configuração excelente para controle, mas deve ser aplicada com atenção. Um caminho omitido pode causar falhas em uploads, sessões, caches ou carregamento de bibliotecas.

Atenciosamente,
MyWay Hosting
Servidores Otimizados por inteligência artificial
www.myway.com.br

0 Usuários acharam útil