Opciones de apertura de secuencia

(no version information, might be only in CVS)

Opciones de apertura de secuencia -- Afecta la operación de las funciones de fábrica de secuencias

Descripción

Uno o más de éstos valores pueden ser combinados usando el operador OR.

IGNORE_PATH

Esta es la opción predeterminada para las secuencias; solicita que include_path no sea usado en busca del archivo requerido.

USE_PATH

Solicita que include_path sea usado en busca del archivo requerido.

IGNORE_URL

Solicita que las envolturas de URL registradas sean ignoradas cuando se abra la secuencia. Otras envolturas que no sean de URL serán tomadas en cuenta cuando se decodifique la ruta. No hay un valor opuesto para ésta bandera; la API de secuencias usa todas las envolturas registradas por defecto.

IGNORE_URL_WIN

En sistemas windows, éste es el equivalente a IGNORE_URL. En todos los otros sistemas, ésta bandera no tiene efecto alguno.

ENFORCE_SAFE_MODE

Solicita que la implementación interna de secuencia realice chequeos de safe_mode sobre el archivo antes de abrirlo. Al omitir ésta bandera se evitarán los chequeos de safe_mode y permite abrir cualquier archivo sobre el que el proceso de PHP tengo privilegios de acceso.

REPORT_ERRORS

Si ésta bandera se encuentra activa, y hubo un error durante la apertura del archivo o URL, la API de secuencias llamará la función php_error por usted. Esto es útil ya que la ruta puede contener información sobre nombres de usuario/contraseñas que no debería ser desplegada en la salida del navegador (cosa que sería un riesgo de seguridad). Cuando la API de secuencias genera un error, primero retira cualquier información de nombres de usuario/contraseñas de la ruta, haciendo que sea seguro mostrar el mensaje de error en el navegador.

STREAM_MUST_SEEK

Esta bandera es útil cuando su extensión realmente debe ser capaz de hacer búsquedas aleatorias en una secuencia. Algunas secuencias pueden no ser reubicables en su forma nativa, así que ésta bandera le pide a la API de secuencias que chequee si la secuencia soporta la reubicación. Si no lo hace, copiará la secuencia en un almacenamiento temporal (que puede tratarse de un archivo temporal o una secuencia en memoria) que sí soporte búsquedas. Por favor note que ésta bandera no es útil cuando usted quiere hacer búsquedas en la secuencia y escribir sobre ella, ya que la secuencia con la que trabaja puede no estar asociada con el recurso real que usted solicitó.

Nota: Si el recurso solicitado es basado en red, ésta bandera causará que el proceso de apertura bloquee hasta que el contenido completo haya sido descargado.

STREAM_WILL_CAST

Si su extensión usa una biblioteca externa que espera un descriptor de archivo FILE*, puede usar esta bandera para solicitar a la API de secuencias que abra el recurso pero que evite el uso de búferes. Puede usar entonces php_stream_cast() para recuperar el apuntador FILE* o descriptor de archivo que la biblioteca requiere.

Esto es particularmente útil cuando accede a URLs HTTP en donde el inicio de los datos reales de la secuencia se encuentra después de un desplazamiento indeterminado al interior de la secuencia.

Ya que esta opción deshabilita el uso de búferes en el nivel del API de secuencias, usted puede experimentar un rendimiento inferior cuando usa funciones de secuencias sobre ella; esto es considerado aceptable ya que usted le ha indicado a la API que estará usando las funciones para adaptar la implementación interna de secuencias. Use esta opción únicamente cuando esté seguro de que la necesita.

Hosting by: hurra.com
Generated: 2007-01-26 18:00:54