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.

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

O Cloud Functions dá suporte a várias versões do PHP, que estão listadas na página Suporte ao ambiente de execução. Selecione seu ambiente de execução PHP preferencial para a função durante a implantação.

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 Implantação com a CLI do Google Cloud.

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:


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