(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)
streamWrapper::url_stat — Lee la información sobre un fichero
Este método es llamado en respuesta a todas las funciones relacionadas con stat(), tales como:
path
La ruta de acceso del fichero o la URL a analizar. Se debe tener en cuenta que en el caso de las URLs, deben estar delimitadas por ://. Cualquier otro formato no es soportado.
flags
Las opciones adicionales activadas por la API de flujos. Puede contener una o más de las constantes siguientes, combinadas por OR:
Opción | Descripción |
---|---|
STREAM_URL_STAT_LINK | Para los recursos que tienen la capacidad de enlazarse a otros recursos (como una redirección HTTP o un enlace simbólico). Esta opción indica que la información leída debe concernir al enlace en sí mismo, y no al recurso apuntado por el enlace. Esta opción es activada en respuesta a una llamada a lstat(), is_link() o filetype(). |
STREAM_URL_STAT_QUIET | Si esta opción está activada, el gestor no debe emitir errores. Si esta opción no está activada, se es responsable del informe de errores, llamando a la función trigger_error() durante el análisis de la ruta de acceso. |
Debe retornar un tableau con tantos elementos como stat() retorna.
Los valores desconocidos o no disponibles deben tomar un valor
razonable (generalmente, 0
). Se debe prestar especial
atención a mode
como está documentado bajo
stat().
Debe retornar false
en caso de fallo.
Emite un
E_WARNING
si la llamada a este método falla
(por ej., por no estar implementado).
Nota:
La propiedad streamWrapper::$context es actualizada si se pasa un contexto válido en la función invocante.