Alojamento web - Ambiente, versão PHP, .ovhconfig

Bases de conhecimento

Alojamento web - Ambiente, versão PHP, .ovhconfig


Icons/System/eye-open Created with Sketch. 1061 visualizações 15.12.2025 Web / Alojamento web
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

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

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:

AmbienteLegacyStableStable64
Arquitetura32 bits32 bits64 bits
Versão PHP mínima5.45.47.4
OpenSSL1.0.1t1.0.1t1.1.1n
Python2.7 e 3.42.7 e 3.72.7 e 3.7
Ruby2.12.12.5
Rails4.14.15.2
Perl5.205.205.28
git2.12.12.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 PHPAmbientes de execução compatíveis
5.4, 5.5, 5.6 e 7.0Legacy, Stable
7.1, 7.2 e 7.3Stable
7.4, 8.0, 8.1, 8.2, 8.3, 8.4 e 8.5stable64

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 em Alojamentos e escolha o alojamento web em causa. No separador Informações gerais, localize a versão abaixo de Versão global de PHP.

phpversion

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:
<?php phpinfo(); ?>

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.

ModoCache dos ficheiros estáticosTratamento dos erros PHP
ProductionMaximiza o armazenamento em cache dos ficheiros estáticos nos browsers.Os erros PHP não aparecem no seu site.
DevelopmentNã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.

Web Cloud

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

Web Hosting

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

Global PHP version

À 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}.

EscolhaDetalhes
Voltar a uma configuração anteriorDepois 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 atualDepois 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.

hostingconfiguration

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.

Web Cloud

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

Web Hosting

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

FTP - SSH

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

FTP - SSH tab

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:

app.engine=php
app.engine.version=8.0

http.firewall=none
environment=production

container.image=stable64

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áveisDetalhe
app.enginePermite alterar o motor PHP utilizado pelo alojamento. Introduza php para ativar o acelerador PHP-FPM e phpcgi para o desativar.
app.engine.versionPermite 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.firewallPermite ativar ou desativar a firewall fornecida com os alojamentos web da OVHcloud. Introduza security para a ativar ou none para a desativar.
environmentPermite 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.imagePermite 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":

; ovhconfig
;
; this file must be placed in $HOME/.ovhconfig or in $DOCUMENT_ROOT/.ovhconfig

; __app.engine__
;
; values: php (php engine + opcache accelerator)
; notice: if php, a phpcgi engine will be activated as fallback (if previous engine crash)
;
;   php:
;       IMPORTANT: register_globals and magic_quotes_gpc are off for security
;       php optiones .htaccess (like php version) are ignored
;   phpcgi:
;       IMPORTANT this is a fallback to previous system
;       in this case __app.engine.version__ will be considerated as AUTO and php version will be old system
;       (meaning depending .htaccess or .phpX extension)
;
app.engine=php

; __app.engine.version__ specify version of your engine
;
; for php:
;   default: 8.0
; for phpcgi:
;   this options is ignored (= fallback in AUTO)
;
app.engine.version=8.0

; __http.firewall__ used to add application firewall  (filter http requests)
;
; values: none | security
; default: none
;
http.firewall=none

; __environment__
;
; values: production | development
;
;   production:
;       apache will maximise local cache
;       mod_expires will grow up TTL of js, css, pdf, images, video, audio
;       you can override it changing expiration explicitly in your .htaccess
;       feel free to look on our guide.
;   development:
;       no expiration is added, files are not locally in cache,
;       will speed up tests but decrease performances
;
; choosen environment will also be available in your variable ENVIRONMENT unix env
;
; default: production
;
environment=production

; __container.image__
;
; values: legacy | stable | stable64
;
container.image=stable64

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.

ovhconfig

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.

Artigos relacionados