streamWrapper::stream_open

(PHP 4 >= 4.3.2, PHP 5)

streamWrapper::stream_open — Abre un archivo o una URL

Descripción

public bool streamWrapper::stream_open ( string $path , string $mode , int $options , string &$opened_path )

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

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Errores/Excepciones

Emite un E_WARNING si la llamada a este método falla (por ej., por no estar implementado).

Notas

Nota:

La propiedad streamWrapper::$context es actualizada si se pasa un contexto válido en la función invocante.

Ver también

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