Alojamento web - Ambiente, versão PHP, .ovhconfig
Informações sobre a tradução
Esta tradução foi automaticamente gerada pelo nosso parceiro SYSTRAN. Em certos casos, poderão ocorrer formulações imprecisas, como por exemplo nomes de botões ou detalhes técnicos. Recomendamos que consulte a versão inglesa ou francesa do manual, caso tenha alguma dúvida. Se nos quiser ajudar a melhorar esta tradução, clique em "Contribuir" nesta página.
Objetivo
As ofertas de alojamento web da OVHcloud permitem alojar o site que quiser, desde que seja compatível com a configuração das nossas infraestruturas partilhadas.
A modificação do ficheiro php.ini não está disponível nas ofertas de alojamento web. Isto porque a configuração PHP é global para o conjunto da infraestrutura partilhada. No entanto, nas nossas infraestruturas partilhadas, pode modificar os seguintes parâmetros para o seu alojamento web:
Existem duas formas de alterar estas definições de configuração:
- a partir da sua Área de Cliente OVHcloud ;
- a partir do espaço de armazenamento FTP do seu alojamento web OVHcloud, por meio de um ficheiro chamado ".ovhconfig".
Os ficheiros ".ovhconfig" são ficheiros de configuração de servidores e são automaticamente reconhecidos como tal pela infraestrutura de alojamento partilhado. Eles estão presentes de forma nativa e por predefinição na "raiz FTP" do espaço de armazenamento FTP do seu alojamento web. Contêm os valores dos elementos acima mencionados.
Em resumo, alterar a configuração do seu alojamento web a partir da Área de Cliente OVHcloud ou modificar os valores presentes no ficheiro ".ovhconfig" equivale a realizar a mesma operação.
Índice
- 1 - Descrição dos parâmetros de configuração disponíveis nos alojamentos web da OVHcloud
- 2 - Método 1: Alterar a configuração do alojamento web a partir da Área de Cliente OVHcloud
- 3 - Método 2: Alterar a configuração do alojamento web a partir do ficheiro ".ovhconfig"
- 4 - Utilização avançada dos ficheiros ".ovhconfig"
Saiba como alterar o ambiente de execução, a versão PHP, a firewall aplicacional, o motor, o modo e o ficheiro ".ovhconfig" de um alojamento web.
Requisitos
- Dispor de um serviço de alojamento web OVHcloud, com exceção de um serviço de alojamento Cloud Web.
- Ter acesso à sua oferta de alojamento web a partir da Área de Cliente OVHcloud ou conhecer as informações que permitem ligar-se à Área de armazenamento FTP.
Instruções
1 - Descrição dos parâmetros de configuração disponíveis nos alojamentos web da OVHcloud
Antes de começar, encontrará de seguida a descrição técnica de cada um dos parâmetros editáveis nos alojamentos web da OVHcloud.
A alteração de, pelo menos, um destes itens pode afetar a visualização ou o funcionamento do website. Assegure-se de que o seu website é compatível com as alterações que deseja efetuar na configuração do seu alojamento web. Contacte um fornecedor especializado em caso de dúvida ou se encontrar dificuldades.
1.1 - Os ambientes de execução
Os ambientes de execução contêm um conjunto de linguagens de programação. Em função do ambiente de execução escolhido, as linguagens estão disponíveis em versões mais ou menos avançadas. O objetivo destes ambientes é permitir-lhe executar corretamente os ficheiros que compõem o seu website, de acordo com as suas necessidades técnicas.
Nos alojamentos web da OVHcloud, oferecemos 3 ambientes de execução: Legacy, Stable e Stable64. Encontre aqui os elementos contidos nos nossos diferentes ambientes de execução:
| Ambiente | Legacy | Stable | Stable64 |
|---|---|---|---|
| Arquitetura | 32 bits | 32 bits | 64 bits |
| Versão PHP mínima | 5.4 | 5.4 | 7.4 |
| OpenSSL | 1.0.1t | 1.0.1t | 1.1.1n |
| Python | 2.7 e 3.4 | 2.7 e 3.7 | 2.7 e 3.7 |
| Ruby | 2.1 | 2.1 | 2.5 |
| Rails | 4.1 | 4.1 | 5.2 |
| Perl | 5.20 | 5.20 | 5.28 |
| git | 2.1 | 2.1 | 2.20 |
O ambiente Legacy pode ser útil para sites antigos que ainda utilizem versões antigas de PHP. No entanto, recomendamos vivamente que utilize o ambiente Stable64 que beneficia das últimas atualizações. Certifique-se de que o seu website é compatível antes de realizar qualquer alteração.
1.2 - As versões de PHP
PHP é uma linguagem de programação dinâmica utilizada para criar websites. Para o seu website, e em função da sua antiguidade, das atualizações efetuadas ou de certas variáveis necessárias ao seu bom funcionamento, poderá ser necessário alterar a versão de PHP que utiliza.
Existem várias versões da linguagem de programação PHP. A evolução das versões traz correções diversas, assim como a adição ou o encerramento de funcionalidades. A OVHcloud propõe as últimas versões principais de PHP da qual pode encontrar a lista aqui.
Certas versões de PHP só funcionam com certos ambientes de execução. Encontrará abaixo as versões de PHP disponíveis nos alojamentos partilhados OVHcloud e os ambientes de execução compatíveis:
| Versões PHP | Ambientes de execução compatíveis |
|---|---|
| 5.4, 5.5, 5.6 e 7.0 | Legacy, Stable |
| 7.1, 7.2 e 7.3 | Stable |
| 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 e 8.5 | stable64 |
Uma vez que as novas versões podem não incluir determinadas funcionalidades, certifique-se de que a nova versão de PHP é compatível com o seu website antes de realizar qualquer alteração.
Embora a OVHcloud trate da instalação das versões mais recentes de PHP nos seus servidores, cabe-lhe a si assegurar que o seu website está sempre atualizado e compatível com as versões mais recentes de PHP. Em função do website que utiliza, existem duas formas de verificar:
Caso n°1 - utiliza um Content Management System (CMS) tal como WordPress, Joomla!, PrestaShop ou Drupal :
- Consulte a documentação oficial criada pelo editor do CMS que utiliza.
- Tome nota das informações relativas aos requisitos técnicos necessários ao funcionamento do seu CMS, assim como à manipulação necessária para o atualizar.
- Se necessário, atualize o seu CMS garantindo que a nova versão é compatível com o alojamento web da OVHcloud.
Caso n°2 - utiliza um site baseado numa solução personalizada :
- Aproxime-se do webmaster que criou o website.
- Consulte a documentação oficial PHP para obter mais informações sobre as migrações da versão.
- Se necessário, atualize o código do seu website assegurando-se de que este é compatível com o alojamento web da OVHcloud.
Se necessário, pode conhecer a versão de PHP atualmente utilizada pelo seu alojamento web de duas formas:
- Através da Área de Cliente OVHcloud. Aceda à Área de Cliente OVHcloud e aceda à secção
Web Cloud. Na coluna da esquerda, clique emAlojamentose escolha o alojamento web em causa. No separadorInformações gerais, localize a versão abaixo de Versão global de PHP.

Se vir um símbolo redondo azul, aguarde alguns minutos para que a versão seja atualizada.
- Através de um script. Crie um script .php que contenha apenas o seguinte código:
De seguida, coloque-o online no seu espaço de armazenamento FTP e ligue-o para o seu endereço/URL completo.
A modificação da versão de PHP através de um ficheiro ".htaccess" já não é possível nas ofertas mais recentes de alojamento web OVHcloud.
O comando que permite mudar a versão de PHP no ficheiro ".htaccess" também não permite a utilização de versões recentes de PHP nas nossas infraestruturas.
É obrigatório que utilize o ficheiro ".ovhconfig".
1.3 - Os motores de execução PHP
Os motores de execução PHP são programas que permitem executar ações no servidor web segundo um determinado método. Geralmente, esta configuração é modificada para agir sobre a velocidade de execução dos pedidos gerados pelos visitantes do seu website.
Nos alojamentos web da OVHcloud, disponibilizamos 2 motores de execução PHP: php ("PHP-FPM") e phpcgi.
A escolha do motor php permite ativar ou desativar o acelerador PHP ("PHP-FPM"). que foi adaptado à nossa infraestrutura para acelerar a velocidade de execução dos scripts PHP.
O motor phpcgi executa os pedidos "em série" ao contrário do motor php ("PHP-FPM") que os executa "em paralelo".
Em comparação, o acelerador PHP ("PHP-FPM") oferece um ganho de performance até sete vezes mais rápido do que a utilização do motor phpcgi.
1.4 - A firewall aplicacional
Uma firewall é uma segurança que filtra os pedidos recebidos do seu alojamento web. Nos nossos alojamentos web, esta definição de configuração funciona como uma opção ativável ou desativável. Não será possível alterar as definições de filtragem da firewall propriamente dita.
Consulte o guia "Ativação da firewall da aplicação" para mais informações sobre o assumpto.
Se utilizar módulos de pagamento, a ativação da firewall aplicacional pode, por vezes, causar perturbações na comunicação entre o módulo de pagamento e os bancos. Nesse caso, desative a opção.
1.5 - Modos de execução
Os modos de execução permitem gerir o comportamento da cache dos ficheiros estáticos do seu website (as imagens, por exemplo) e o tratamento dos erros PHP (úteis quando o seu site apresenta uma página branca, por exemplo).
Existem 2 modos que pode ativar: Production e Development.
| Modo | Cache dos ficheiros estáticos | Tratamento dos erros PHP |
|---|---|---|
| Production | Maximiza o armazenamento em cache dos ficheiros estáticos nos browsers. | Os erros PHP não aparecem no seu site. |
| Development | Não é aplicada nenhuma cache. | Os erros PHP aparecem no seu site. |
Para as versões 7.1 e posteriores de PHP, os erros aparecerão no site, independentemente do modo utilizado.
Agora que conhece os diferentes parâmetros alteráveis para o seu alojamento web OVHcloud, descubra os dois métodos para modificar estes parâmetros.
2 - Método 1: alterar a configuração do alojamento web a partir da Área de Cliente OVHcloud
Lembre-se de que a alteração de, pelo menos, um destes itens pode afetar a visualização ou o funcionamento do website. Assegure-se de que o seu website é compatível com as alterações que deseja efetuar na configuração do seu alojamento web. Contacte um fornecedor especializado em caso de dúvida ou se encontrar dificuldades.
2.1 - Aceder à gestão da configuração do alojamento web
Clique nas janelas abaixo para visualizar cada uma das etapas 3.
Aceda à Área de Cliente OVHcloud e aceda à secção Web Cloud.

Clique no menu Alojamentos e escolha o alojamento web em causa.

No marco Configuração, encontrará Versão global de PHP.

À direita da entrada Versão global de PHP, localizada quase no centro da página, clique no botão ... e, a seguir, em Alterar configuração.
Se o botão Alterar configuração estiver cinzento, é possível que esteja a decorrer uma verificação da Versão global de PHP. Se for o caso, aparecerá um símbolo redondo azul junto da versão, indicando que a verificação está em curso. Aguarde alguns minutos para que o botão Alterar configuração volte a ficar acessível.
Se a opção Versão global de PHP não aparecer na Área de Cliente OVHcloud, verifique se o ficheiro .ovhconfig existe na raiz de FTP do seu alojamento partilhado OVHcloud.
Encontre todas as informações relativas ao ficheiro .ovhconfig na terceira parte "Método 2: alterar a configuração do alojamento web a partir do ficheiro ".ovhconfig"" deste guia.
2.2 - Alterar a configuração do alojamento web
Aparecerá uma janela com duas opções possíveis. Selecione a que corresponde à ação que deseja realizar e clique em ‘Seguinte`{.action}.
| Escolha | Detalhes |
|---|---|
Voltar a uma configuração anterior | Depois de selecionar esta opção, escolha a configuração a restaurar ao lado de Choice Histórico. Esta opção não estará disponível se não tiver efetuado nenhuma alteração anteriormente. |
Alterar a configuração atual | Depois de selecionar esta opção, escolha as alterações que deseja introduzir na configuração entre os campos propostos. Se necessário, volte à primeira parte "Descrição dos parâmetros de configuração disponíveis nos alojamentos web da OVHcloud" deste guia. |
Alterar o ambiente de execução do seu alojamento web reinicializa automaticamente as sessões PHP.
Clique em Validar para aplicar a alteração. Aguarde alguns instantes até que ela se realize.

3 - Método 2: modificar a configuração do alojamento web a partir do ficheiro ".ovhconfig"
3.1 - Aceder ao espaço de armazenamento FTP do seu alojamento web
Tenha consigo o seu nome de utilizador FTP, a respetiva palavra-passe e o endereço do servidor FTP.
Para isso, clique nas janelas abaixo para visualizar cada uma das etapas 4.
Aceda à Área de Cliente OVHcloud e aceda à secção Web Cloud.

Clique no menu Alojamentos e escolha o alojamento web em causa.

Na página que se abrir, clique no separador FTP - SSH.

Nele, encontrará informações que lhe permitem aceder.

Quanto à palavra-passe do utilizador FTP, consulte as instruções descritas no manual "Alterar a palavra-passe de um utilizador FTP" se necessário.
3.2 - Recuperar ou criar o ficheiro ".ovhconfig"
Quando estiver conectado ao espaço de armazenamento FTP, visualizará o conjunto dos ficheiros alojados atualmente no seu espaço de armazenamento FTP. Fique posicionado na raiz do seu alojamento (que pode ser simbolizado por um "/"). Deverá encontrar o ficheiro ".ovhconfig".
A partir daí, existem duas possibilidades:
- O ficheiro ".ovhconfig" está presente : descarregue-o para a sua própria máquina / aparelho. Faça uma cópia antes de modificá-lo. Esta ferramenta permitir-lhe-á restaurar o ficheiro original, se necessário.
- O ficheiro ".ovhconfig" é inexistente : crie-o na sua própria máquina/aparelho e dê-lhe o nome ".ovhconfig".
3.3 - Alterar o conteúdo do ficheiro ".ovhconfig"
Depois de obter o ficheiro ".ovhconfig", edite-o. Para o fazer, utilize um programa de edição de texto. O seu ficheiro ".ovhconfig" deve conter um código semelhante ao seguinte:
Se acabou de criar o ficheiro ".ovhconfig", copie o código acima no seu ficheiro e continue a ler este guia.
Personalize os valores das variáveis em função da configuração que pretende utilizar com o seu alojamento web.
| Variáveis | Detalhe |
|---|---|
| app.engine | Permite alterar o motor PHP utilizado pelo alojamento. Introduza php para ativar o acelerador PHP-FPM e phpcgi para o desativar. |
| app.engine.version | Permite definir a versão de PHP utilizada pelo alojamento entre as que a OVHcloud propõe. Insira a versão da sua escolha (adequada ao ambiente de execução que escolheu utilizar). |
| http.firewall | Permite ativar ou desativar a firewall fornecida com os alojamentos web da OVHcloud. Introduza security para a ativar ou none para a desativar. |
| environment | Permite gerir o comportamento da cache dos ficheiros estáticos do seu website, assim como o tratamento dos erros PHP. Corresponde a modo de execução. Insira production para maximizar a colocação em cache e ocultar os erros PHP ou development para que nenhuma cache seja aplicada e que os erros PHP sejam apresentados. |
| container.image | Permite alterar o ambiente de execução utilizado pelo alojamento. Indique o ambiente de execução (legacy,stable ou stable64) à sua escolha. Se escolher o ambiente de execução stable64, verifique se o seu site é compatível com a arquitetura de 64 bits. |
Se necessário, volte à primeira parte "Descrição dos parâmetros de configuração disponíveis nos alojamentos web da OVHcloud" deste guia.
Se necessário, encontre abaixo a descrição técnica detalhada do ficheiro ".ovhconfig":
3.4 - Transferir o ficheiro ".ovhconfig" no espaço de armazenamento
Depois de" alterado o ficheiro ".ovhconfig, transfira-o para o seu espaço de armazenamento FTP. Para isso, volte a ligar-se ao seu espaço de armazenamento FTP e coloque-se na raiz do seu espaço de armazenamento FTP (que pode ser simbolizado por um "/"). Carregue o ficheiro ".ovhconfig" que acabou de modificar no seu espaço de armazenamento FTP. Se o ficheiro já existir, substitua-o.
4 - Utilização avançada dos ficheiros ".ovhconfig"
Se está a utilizar o seu alojamento web para alojar vários sítios web, pode haver diversas razões pelas quais pretende beneficiar de uma versão de PHP diferente para alguns dos seus sítios web.
Crie um ficheiro ".ovhconfig" contendo a versão de PHP desejada para o(s) sítio(s) web em questão. Utilize as manipulações descritas na parte "3.3 - Modificar o conteúdo do ficheiro ".ovhconfig"" deste guia, se necessário. Quando fizer o upload do ficheiro ".ovhconfig" para o seu espaço de armazenamento FTP, faça-o na pasta raiz onde se encontram os ficheiros que compõem o sítio web em questão. Encontre a pasta raiz do seu sítio web a partir do seu Área de Cliente OVHcloud no separador Multisite do alojamento em questão.
Consulte o nosso guia detalhado sobre como configurar um sítio web num alojamento web, se necessário.
Não é possível especificar um segundo ambiente de execução, um segundo modo de execução e/ou um segundo motor de execução PHP num mesmo alojamento web. Apenas serão tidos em conta os que constam do ficheiro ".ovhconfig" que está na raiz do seu espaço de armazenamento FTP.

Quer saber mais?
Ligar-se ao espaço de armazenamento do alojamento web
Para serviços especializados (referenciamento, desenvolvimento, etc), contacte os parceiros OVHcloud.
Se pretender usufruir de uma assistência na utilização e na configuração das suas soluções OVHcloud, consulte as nossas diferentes ofertas de suporte.
Fale com nossa comunidade de utilizadores.