Generalidades

La API de Secuencias de PHP introduce un enfoque unificado a la gestión de archivos y sockets en extensiones PHP. Usando una API única con funciones estándar para operaciones comunes, la API de secuencias le permite a su extensión acceder a archivos, sockets, URLs, memoria y objetos definidos por-script. Esta es una API extensible de tiempo de ejecución que permite la carga dinámica de módulos (¡y scripts!) para registrar nuevas secuencias.

El propósito de la API de secuencias es facilitar la apertura de archivos, URLs y otras fuentes de datos secuenciables a los desarrolladores, mediante una API unificada que es fácil de entender. La API se encuentra más o menos basada en la familia de funciones ANSI C stdio (con una semántica idéntica para la mayoría de sus funciones principales), así que los progamadores de C tendrán una sensación de familiaridad con las secuencias.

La API de secuencias opera en un par de niveles diferentes: al nivel base, la API define objetos php_stream para representar fuentes de datos secuenciables. En un nivel ligeramente más alto, la API define objetos php_stream_wrapper que "envuelven" la API de nivel más bajo para proveer soporte para la recuperación de datos y meta-datos desde URLs. Un parámetro de contexto adicional, aceptado por la mayoría de funciones de creación de secuencia, es pasado al método stream_opener de la envoltura para configurar en detalle el comportamiento de la misma.

Cualquier secuencia, una vez abierta, puede tener también cualquier número de filtros aplicados sobre ella, los cuales procesan datos en la medida en que éstos son leídos desde/escritos hacia la secuencia.

Las secuencias pueden ser moldeadas (convertidas) a otros tipos de gestores de archivo, de modo que puedan ser usadas con bibliotecas externas sin mucho problema. Esto permite que aquellas bibliotecas accedan a datos directamente desde fuentes tipo URL. Si su sistema tiene la función fopencookie() o funopen(), ¡puede pasar incluso cualquier secuencia PHP a cualquier biblioteca que use stdio ANSI!