Como emitir solicitações HTTP(S)

Esta página descreve como emitir solicitações HTTP(S) do seu aplicativo App Engine.

Emitir uma solicitação HTTP

A linguagem PHP oferece várias funções para fazer solicitações HTTP remotas. Elas são implementadas de diferentes maneiras no Google App Engine e estão sujeitas a várias cotas e custos:

• Gerenciadores de stream: os manipuladores de stream nativo http:// e https:// do PHP são configurados para usar o serviço de busca de URL do App Engine para fazer solicitações HTTP. Muitas funções do PHP, como file_get_contents(), usam os gerenciadores de stream indiretamente. Portanto, também usam o serviço de busca de URL.
• Extensão cURL: a extensão cURL usa o serviço de soquetes. A extensão cURL precisa estar ativada no arquivo php.ini do aplicativo. Além disso, é necessário que o faturamento esteja ativado para o projeto.
• cURL "lite": o cURL "lite" é uma versão da biblioteca cURL fornecida pelo Google que usa o serviço de busca de URL em vez do serviço de soquetes. Ative o cURL "lite" no arquivo php.ini do seu aplicativo. Os seguintes métodos da extensão cURL não são compatíveis:
  • curl_multi_* função
  • suporte a protocolos não padrão
  • suporte a outras portas, além da 80 (HTTP) ou 443 (HTTPS)

A decisão entre usar cURL, cURL Lite ou wrappers de stream depende muito do aplicativo e de sua preferência. Se você não tem certeza, use a biblioteca HTTP do Guzzle. O Guzzle oferece uma camada de abstração para solicitações HTTP, o que permite alterar o serviço subjacente sem reescrever o código do aplicativo.

$url = 'http://httpbin.org/post?query=update';
$data = ['data' => 'this', 'data2' => 'that'];
$headers = "accept: */*\r\n" .
    "Content-Type: application/x-www-form-urlencoded\r\n" .
    "Custom-Header: custom-value\r\n" .
    "Custom-Header-Two: custom-value-2\r\n";

$context = [
    'http' => [
        'method' => 'POST',
        'header' => $headers,
        'content' => http_build_query($data),
    ]
];
$context = stream_context_create($context);
$result = file_get_contents($url, false, $context);

$url = 'http://httpbin.org/post?query=update';
$data = ['data' => 'this', 'data2' => 'that'];
$headers = [
    'Accept: */*',
    'Content-Type: application/x-www-form-urlencoded',
    'Custom-Header: custom-value',
    'Custom-Header-Two: custom-value-2'
];

// open connection
$ch = curl_init();

// set curl options
$options = [
    CURLOPT_URL => $url,
    CURLOPT_POST => count($data),
    CURLOPT_POSTFIELDS => http_build_query($data),
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
];
curl_setopt_array($ch, $options);

// execute
$result = curl_exec($ch);

// close connection
curl_close($ch);

$url = 'http://httpbin.org/post?query=update';
$data = ['data' => 'this', 'data2' => 'that'];
$headers = [
    'Accept' => '*/*',
    'Content-Type' => 'application/x-www-form-urlencoded',
    'Custom-Header' => 'custom-value',
    'Custom-Header-Two' => 'custom-value',
];

$guzzle = new GuzzleHttp\Client;
$request = new GuzzleHttp\Psr7\Request('POST', $url, $headers, http_build_query($data));
$result = $guzzle->send($request);

Definir um tempo limite de solicitação

Use a opção timeout em Contexto HTTP para alterar o prazo.

Desativar redirecionamentos

Se você estiver usando a busca de URL, o serviço subjacente de busca de URL seguirá até cinco redirecionamentos por padrão. Esses redirecionamentos podem encaminhar informações confidenciais, como cabeçalhos de autorização, para o destino redirecionado. Se o aplicativo não exigir redirecionamentos HTTP, é recomendável que você os desative.

Para instruir o serviço de busca de URL a não seguir redirecionamentos, seu aplicativo precisa definir o parâmetro follow_location nas Opções de contexto HTTP para false.

Emitir uma solicitação HTTPS

Por padrão, o serviço de busca de URL subjacente valida o certificado do host que ele contata e rejeita solicitações se o certificado não corresponder. Não é necessário proteger explicitamente sua solicitação.

Desativar a validação do certificado do host

Por padrão, a implementação do wrapper HTTPS do App Engine tenta validar o certificado do host e rejeita as solicitações em que o certificado não corresponde. Para desativar esse comportamento, defina o valor de verify_peer como false nas opções de contexto SSL/TLS.

Emitir uma solicitação para outro app do App Engine

Ao emitir uma solicitação para outro aplicativo do App Engine, ele precisa declarar a identidade dele adicionando o cabeçalho X-Appengine-Inbound-Appid à solicitação. Se você instruir o serviço de busca de URL a não seguir redirecionamentos, o App Engine adicionará esse cabeçalho às solicitações automaticamente.

Consulte Como desativar redirecionamentos para orientação sobre como desativar redirecionamentos.

A seguir

Para saber mais sobre o serviço de busca de URL, como os cabeçalhos que são enviados em uma solicitação de busca de URL, consulte Solicitações de saída.