O tempo de execução do PHP

A função do Cloud Run é 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 dá suporte 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 das funções do Cloud Run.

Para começar a usar o PHP nas funções do Cloud Run, consulte o Guia de início rápido.

Selecionar o ambiente de execução

As funções do Cloud Run dão 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. Por exemplo:

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

FLAGS... refere-se a argumentos transmitidos durante a primeira implantação da função. Para mais informações sobre argumentos obrigatórios e opcionais, 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 as funções do Cloud Run encontrem a definição da sua função, seu código-fonte precisa seguir uma estrutura específica. Consulte Como escrever funções do Cloud Run para 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