O ambiente de execução do PHP

A função do Cloud Run é executada em um ambiente que consiste em uma versão do sistema operacional com pacotes complementares, suporte a linguagens e a biblioteca PHP Functions Framework que dá suporte e invoca a função. Esse ambiente é identificado pela versão da linguagem e é conhecido como ID de execução.

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 Usar PHP no Google Cloud.

Selecionar o ambiente de execução

As funções do Cloud Run oferecem suporte a várias versões do PHP, listadas em Ambientes de execução e imagens de base de linguagem compatíveis. Selecione o ambiente de execução PHP preferencial para a função durante a implantação.

gcloud

Para usar as funções do Cloud Run para implantar uma função HTTP usando a CLI gcloud, consulte Implantar usando a Google Cloud CLI.

Console

Se você estiver usando o console do Google Cloud , selecione o ambiente de execução ao criar e implantar a função. Consulte o Google Cloud guia de início rápido do console para instruções detalhadas.

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 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

O PHP usa o Composer para gerenciar as dependências. É possível especificar dependências para a função adicionando-as a um arquivo de projeto chamado composer.json.

O ambiente de execução PHP do Cloud Run functions exige que o Functions Framework seja uma dependência explícita. Para adicionar o Functions Framework como uma dependência, execute o seguinte comando no diretório que contém o código da função. Ele também precisa conter o arquivo composer.json:

composer require google/cloud-functions-framework

Isso adiciona o Functions Framework ao seu composer.json e instala o pacote no diretório vendor/.

Arquivo autoload.php

Um dos arquivos contidos no seu diretório vendor/ é autoload.php.

Adicione a seguinte linha na parte superior dos scripts PHP para solicitar o arquivo autoload.php, que automaticamente require(solicita) as outras dependências da função:

require_once __DIR__ . '/vendor/autoload.php';

Por padrão, o diretório vendor/ é ignorado no arquivo gerado .gcloudignore para reduzir o número de arquivos enviados na implantação.