array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.curl_upkeep.php', 1 => 'curl_upkeep', 2 => 'Executa qualquer verificação de manutenção de conexão', ), 'up' => array ( 0 => 'ref.curl.php', 1 => 'Funções cURL', ), 'prev' => array ( 0 => 'function.curl-unescape.php', 1 => 'curl_unescape', ), 'next' => array ( 0 => 'function.curl-version.php', 1 => 'curl_version', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/curl/functions/curl-upkeep.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

curl_upkeep

(PHP 8 >= 8.2.0)

curl_upkeep — Executa qualquer verificação de manutenção de conexão

Descrição

curl_upkeep(CurlHandle $handle): bool

Disponível se construído em libcurl >= 7.62.0.

Alguns protocolos possuem mecanismos de "manutenção de conexão". Esses mecanismos geralmente enviam algum tráfego nas conexões existentes para mantê-las vivas; isso pode impedir que as conexões sejam fechadas devido a firewalls excessivamente zelosos, por exemplo.

A manutenção da conexão está atualmente disponível apenas para conexões HTTP/2. Uma pequena quantidade de tráfego geralmente é enviada para manter uma conexão ativa. O HTTP/2 mantém sua conexão enviando um quadro PING HTTP/2.

Parâmetros

handle

Um manipulador cURL retornado por curl_init().

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Exemplos

Exemplo #1 Exemplo de curl_upkeep()

<?php
$url = "https://example.com";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTP_VERSION,CURL_HTTP_VERSION_2_0);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_UPKEEP_INTERVAL_MS, 200);
if (curl_exec($ch)) {
usleep(300);
var_dump(curl_upkeep($ch));
}
?>

Veja Também