(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)
streamWrapper::url_stat — Obtém informação sobre um arquivo
Este método é chamado em resposta a todas as funções relacionadas a stat(), como:
pathO caminho ou URL do arquivo a explorar. Note que no caso de uma URL, ela deve ser delimitada com ://. Outras formas de URL não são suportadas.
flagsContém opções adicionais configuradas pela API de fluxos. Pode conter uma ou mais dos valores a seguir somados (com a operação OR).
| Opção | Descrição |
|---|---|
| STREAM_URL_STAT_LINK | Para recursos com a habilidade de criar atalho a outro recurso (como um redirecionamento HTTP ou uma ligação simbólica do sistema de arquivos). Esta opção especifica que apenas informação sobre o atalho em si deve ser retornada, e não sobre o recurso apontado pelo atalho. Esta função é definida em resposta a chamadas a lstat(), is_link() ou filetype(). |
| STREAM_URL_STAT_QUIET | Se esta opção for definida, o empacotador não deve emitir erros. Se a opção não for definida, o programador é responsável por reportar erros usando a função trigger_error() durante a obtenção de informações sobre o arquivo. |
Deve retornar um array com os mesmos elementdos que stat() retorna.
Valores desconhecidos ou indisponíveis devem ser definidos para um valor racional
(normalmente 0). Atenção especial deve ser prestada ao
mode como documentado na função stat().
Deve retornar false em caso de falha.
Emite
um E_WARNING se a chamada a este método falhar
(ou seja, não implementado).
Nota:
A propriedade streamWrapper::$context será atualizada se um contexto válido for passado para a função invocadora.