streamWrapper::url_stat

(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)

streamWrapper::url_stat — Obtém informação sobre um arquivo

Parâmetros

path

O 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.

flags

Conté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.

Valor Retornado

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.

Erros/Exceções

Emite um E_WARNING se a chamada a este método falhar (ou seja, não implementado).

Notas

Note:

A propriedade streamWrapper::$context será atualizada se um contexto válido for passado para a função invocadora.

Veja Também