Opciones de apertura de secuencia

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

Solicita que include_path sea usado en busca del archivo requerido.

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.

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

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.

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.

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ó.

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.