(PHP 4 >= 4.3.2, PHP 5)
streamWrapper::stream_open — Abre un archivo o una URL
$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()).
pathEspecifica 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.
modeEl modo usado para abrir el archivo, como está detallado en fopen().
Nota:
Recuerde verificar si
modees válido para la rutapathsolicitada.
optionsContiene 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.
Devuelve TRUE en caso de éxito o FALSE en caso de error.
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.