streamWrapper::stream_open

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

streamWrapper::stream_open — Abre un archivo o una URL

Descripción

Este método es llamado inmediatemente después de que la envoltura sea inicializada (p.ej. usando fopen() y file_get_contents() ).

Parámetros

path

Especifica la URL que fue pasada a la función original.

Nota:

La URL se puede desmontar con parse_url() . Observe que sólo las URL delimitadas por :// están soportadas. : y :/ aunque técnicamente son URL válidas, no lo están.

mode

El modo usado para abrir el archivo, como está detallado en fopen() .

Nota:

Recuerde verificar si mode es válido para la ruta path solicitada.

options

Contiene banderas adicionales establecidas por la API de flujos. Puede contener uno o más de los siguientes valores usando OR entre ellos.

Bandera	Descripción
STREAM_USE_PATH	Si la ruta path es relativa, se busca el recurso usando include_path.
STREAM_REPORT_ERRORS	Si está establecida esta bandera, uno mismo es responsble de lanzar errores usando trigger_error() durante la apertura del flujo. Si esta bandera no está establecida, no se debería lanzar ningún error.

opened_path

Si la ruta path es abierta con éxito, y STREAM_USE_PATH está establecido en options, opened_path debería ser establecido a la ruta completa del archivo/recurso que fue abierto realmente.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Errores/Excepciones

Emite una advertencia E_WARNING si la llamada a este método falla (i.e. no implementado).

Notas

Nota: La propiedad streamWrapper::$context es actualizada si un contexto válido es pasado a la función.

Véase también

• fopen() - Abre un fichero o un URL
• parse_url() - Analiza una URL y devuelve sus componentes