Versão de PHP num site publicado com o Deploy+

O Deploy+ pode publicar um repositório em qualquer pasta do seu alojamento: public_html, a pasta de um domínio ou de um subdomínio, ou uma pasta dentro de outro site. Nessas pastas, a secção PHP da área de cliente mostra com que versão corre o site, mas não o deixa alterá-la nem fixar uma versão no que está dentro delas.

Porque não se altera a partir da área de cliente

O Deploy+ prepara cada implementação numa pasta nova e, quando está pronta, aponta para ela a pasta publicada. Se a área de cliente escrevesse a versão no .htaccess da pasta publicada, essa linha ficaria na implementação que estava ativa. Na seguinte, o site voltaria à versão anterior sem avisar.

Por isso, num site publicado com o Deploy+, a versão decide-se num destes dois sítios.

No .htaccess do seu repositório

É a opção recomendada quando o site precisa de uma versão concreta: a versão viaja com o código e chega igual em cada implementação.

1. Abra no seu repositório o .htaccess da raiz web, a pasta do repositório que fica publicada. Em Laravel ou Symfony costuma ser public/; em WordPress ou num projeto PHP simples, a raiz do repositório. Vê-a no Deploy+, na configuração do repositório, como Raiz web. Se o ficheiro não existir, crie-o.

2. Adicione a diretiva da versão de que precisa. Por exemplo, para o PHP 8.3:

   AddType application/x-httpd-alt-php83 .php
   

   O número é a versão sem o ponto: 82 para o PHP 8.2, 74 para o PHP 7.4. Tem a lista completa em Versões de PHP diferentes definidas por diretório ou domínio.

3. Se o ficheiro já tiver uma linha com x-httpd-alt-php, não adicione outra: altere apenas o número.

4. Faça commit e implemente.

A versão aplica-se à raiz web e a tudo o que está dentro dela. Para uma pasta concreta do projeto, coloque a diretiva no .htaccess dessa pasta.

Com a versão predefinida da conta

Se o site não tiver versão própria, utiliza a versão predefinida da conta. Essa pode ser alterada a partir da área de cliente, porque não é escrita em nenhuma pasta.

Em Alojamento, abra o seu serviço, vá a PHP e carregue em Alterar na linha Versão predefinida. Tenha em conta que a alteração afeta todos os sites sem versão própria, não apenas o publicado com o Deploy+. Antes e depois, verificamos que respondem, e tem 24 horas para reverter com um botão. Está explicado em Mudar a versão de PHP de um site.

Se o site já tiver versão própria no seu .htaccess, alterar a versão predefinida não a muda: altere-a no repositório.

O que continua a funcionar a partir da área de cliente

• Extensões e limites do PHP: pertencem a cada versão em toda a conta, não a uma pasta, pelo que se alteram a partir da ficha do site como em qualquer outro.
• Erros: o registo de erros do site consulta-se da mesma forma.

Verificar o resultado

Depois de implementar, a secção PHP mostra a nova versão assim que volta a ler os seus sites, o que faz uma vez por dia. Se quiser vê-lo antes, carregue em Atualizar na Ficha técnica do serviço.

Mais sobre o funcionamento das implementações em Implementação automática a partir do GitHub, GitLab ou Bitbucket com rollback instantâneo.