O tempo de execução do PHP

A Função do Cloud é executada em um ambiente que consiste em uma versão do sistema operacional, além de pacotes complementares, suporte a linguagens e a biblioteca do Functions Framework que é compatível e invoca a função. Esse ambiente é identificado pela versão da linguagem e conhecido como ambiente de execução.

O Cloud Functions é compatível com os seguintes ambientes de execução do PHP:

  • PHP 8.2 (recomendado)
  • PHP 8.1
  • PHP 7.4

Esses ambientes de execução usam nginx e PHP-FPM para exibir solicitações. Para saber mais sobre ambientes de execução em geral e qual versão do Ubuntu cada ambiente de execução PHP usa, consulte o Ambiente de execução do Cloud Functions.

Para começar a usar o PHP no Cloud Functions, consulte o Guia de início rápido.

Selecionar o ambiente de execução

Você precisa especificar um ambiente de execução do PHP para executar a função ao implantá-la. Para especificar o ambiente de execução do PHP:

gcloud

Se você estiver usando a Google Cloud CLI, especifique o ambiente de execução usando o parâmetro --runtime. NAME especifica o nome da função. Exemplo:

gcloud functions deploy NAME --runtime php82 --trigger-http

Para mais parâmetros de implantação, consulte Implantar usando a ferramenta gcloud.

Console

Se você estiver usando o console do Google Cloud, consulte o Guia de início rápido do console do Google Cloud para conferir instruções detalhadas.

Preparação de funções

É possível preparar uma função diretamente do console do Google Cloud ou gravá-la na máquina local e fazer upload dela. Para preparar sua máquina local para o desenvolvimento em PHP, consulte Como usar PHP no Google Cloud.

A biblioteca que invoca sua função é o Functions Framework para PHP.

Estrutura do código-fonte

Para que o Cloud Functions encontre a definição da sua função, seu código-fonte precisa seguir uma estrutura específica. Consulte Como escrever Cloud Functions para ver mais informações.

Configuração do PHP

Configure a função PHP com um arquivo php.ini no diretório raiz da função. É possível visualizar as definições de configuração do PHP com a função phpinfo(), conforme mostrado no exemplo de código a seguir:

functions/tips_phpinfo/index.php 

use Psr\Http\Message\ServerRequestInterface;

function phpInfoDemo(ServerRequestInterface $request): string
{
    // phpinfo() displays its output directly in the function's
    // HTTP response, so we don't need to explicitly return it
    //
    // Note: we recommend deleting the deployed Cloud Function once you no
    // longer need it, as phpinfo() may broadcast potential security issues.
    phpinfo();
    return '';
}

Como especificar dependências

É possível especificar dependências para a função adicionando-as a um arquivo de projeto chamado composer.json. Para mais informações, consulte Como especificar dependências em PHP.

A seguir