ToWebs

Descripción

php_stream * php_stream_open_wrapper ( char * ruta, char * modo, int opciones, char ** abierto )

php_stream_open_wrapper() abre una secuencia sobre el archivo, URL, u otro recurso envuelto indicado por ruta. Dependiendo del valor de modo, la secuencia puede ser abierta para lectura, escritura, adición o alguna combinación de éstos modos. Vea la tabla más adelante para conocer los diferentes modos que pueden ser usados; adicionalmente a los caracteres listados más abajo, puede incluir el caracter 'b' ya sea como el segundo o último caracter en la cadena de modo. La presencia del caracter 'b' le informa a la implementación de secuencias en cuestión que abra la secuencia en modo seguro con material binario.

El caracter 'b' es ignorado en todos los sistemas compatibles con POSIX, que tratan los archivos binarios y de texto en la misma manera. Es una buena idea especificar el caracter 'b' cuando su secuencia trabaje con datos en donde todos los 8 bits son importantes, de modo que su código funcione cuando sea compilado en un sistema en donde la bandera 'b' es importante.

Cualquier archivo local creado por la API de secuencias tendrá sus permisos iniciales definidos de acuerdo a los valores predeterminados del sistema operativo - bajo sistemas basados en Unix esto quiere decir que se usará el valor umask del proceso. Bajo Windows, el dueño del archivo será el proceso que lo originó. Todo archivo remoto será creado de acuerdo a la envoltura de URL que fuera usada para abrir el archivo, y las credenciales entregadas al servidor remoto.

r: Abre un archivo de texto para lectura. La secuencia es ubicada al comienzo del archivo.
r+: Abre un archivo de texto para lectura y escritura. La secuencia es ubicada el comienzo del archivo.
w: Trunca el archivo a una longitud de cero, o crea el archivo de texto para escritura. La secuencia es ubicada al comienzo del archivo.
w+: Abre un archivo de texto para lectura y escritura. El archivo es creado si no existe, o de otra forma es truncado. La secuencia es ubicada al comienzo del archivo.
a: Abre para escritura. El archivo es creado si no existe. La secuencia es ubicada al final del archivo.
a+: Abre un archivo de texto para lectura y escritura. El archivo es creado si no existe. La secuencia es ubicada al final del archivo.

opciones afecta el modo en que se interpreta la ruta/URL de la secuencia, los chequeos de modo seguro y las acciones tomadas si hay un error durante la apertura de la secuencia. Vea Opciones de apertura de secuencia para más información sobre las opciones.

Si abierto es diferente a NULL, éste parámetro será definido como una cadena que contiene el nombre del archivo/recurso real que fue abierto. Esto es importante cuando las opciones incluyen USE_PATH, valor que causa que include_path sea usado en busca del archivo. Usted, el origen de la llamada, es responsable de llamar efree() sobre el nombre de archivo devuelto en este parámetro.

Nota: Si ha especificado STREAM_MUST_SEEK en opciones, la ruta devuelta en abierto puede no ser el nombre de la secuencia real que le fue devuelta. Sin embargo, será el nombre del recurso original desde el cual se manufacturó la secuencia sensible a búsquedas.