array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.curl-multi-info-read.php', 1 => 'curl_multi_info_read', 2 => 'Obtém informação sobre as transferências atuais', ), 'up' => array ( 0 => 'ref.curl.php', 1 => 'Funções cURL', ), 'prev' => array ( 0 => 'function.curl-multi-getcontent.php', 1 => 'curl_multi_getcontent', ), 'next' => array ( 0 => 'function.curl-multi-init.php', 1 => 'curl_multi_init', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/curl/functions/curl-multi-info-read.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

curl_multi_info_read

(PHP 5, PHP 7, PHP 8)

curl_multi_info_read — Obtém informação sobre as transferências atuais

Descrição

curl_multi_info_read(CurlMultiHandle $multi_handle, int &$queued_messages = null): array|false

Interroga o multi-identificador se existem mensagens ou informações das transferências individuais. Mensagens podem incluir informações como um código de erro da transferência ou apenas o fato de uma transferência ter sido concluída.

Chamadas repetidas a esta função irão retornar um novo resultado a cada vez, até que um valor false seja retornado como um sinal de que não há mais o que receber no momento. O inteiro apontado pelo parâmetro queued_messages conterá o número de mensagens remanescentes depois que esta função foi chamada.

Aviso

Os dados apontados pelo recurso retornado não irão sobreviver à chamada a curl_multi_remove_handle().

Parâmetros

multi_handle

Um manipulador cURL múltiplo retornado por curl_multi_init().

queued_messages

Número de mensagens que ainda estão na fila

Valor Retornado

Em caso de sucesso, retorna um array associativo para a mensagem, false em caso de falha.

Conteúdo do array retornado
Chave: Valor:
msg A constante CURLMSG_DONE. Outros valores de retorno autalmente não estão disponíveis.
result Uma das constantes CURLE_*. Se tudo estiver correto, a constante CURLE_OK será o resultado.
handle Identificador cURL.

Registro de Alterações

Versão Descrição
8.0.0 O parâmetro multi_handle agora espera uma instância de CurlMultiHandle; anteriormente, um resource era esperado.

Veja Também