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.

Warning

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