streamWrapper::url_stat
(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)
streamWrapper::url_stat — Obtém informação sobre um arquivo
Descrição
Este método é chamado em resposta a todas as funções relacionadas a stat(), como:
- copy()
- fileperms()
- fileinode()
- filesize()
- fileowner()
- filegroup()
- fileatime()
- filemtime()
- filectime()
- filetype()
- is_writable()
- is_readable()
- is_executable()
- is_file()
- is_dir()
- is_link()
- file_exists()
- lstat()
- stat()
- SplFileInfo::getPerms()
- SplFileInfo::getInode()
- SplFileInfo::getSize()
- SplFileInfo::getOwner()
- SplFileInfo::getGroup()
- SplFileInfo::getATime()
- SplFileInfo::getMTime()
- SplFileInfo::getCTime()
- SplFileInfo::getType()
- SplFileInfo::isWritable()
- SplFileInfo::isReadable()
- SplFileInfo::isExecutable()
- SplFileInfo::isFile()
- SplFileInfo::isDir()
- SplFileInfo::isLink()
- RecursiveDirectoryIterator::hasChildren()
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
modo 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
Nota:
A propriedade streamWrapper::$context será atualizada se um contexto válido for passado para a função invocadora.
Veja Também
- stat() - Obtém informações sobre um arquivo
- streamwrapper::stream_stat() - Obtém informação sobre um recurso de arquivo
add a note
