XXVI. Funciones de acceso directo a E/S

Introducción

PHP incluye soporte para funciones de acceso directo a E/S tal y como se especifican en la sección sexta del estándar de Posix. Estas funciones permiten realizar operaciones de E/S a un nivel inferior al de las funciones genéricas de C como fopen() y fread(). Las funciones de acceso directo a E/S solo deberían emplearse cuando se requiere un control directo de un determinado dispositivo. En todos los demás casos, es más adecuado el empleo de las funciones estándar del sistema de archivos.

Nota: This extension has been moved to the PECL repository and is no longer bundled with PHP as of PHP 5.1.0.

Esta extensión solamente está disponible para sistemas Windows a partir de la versión PHP 5.0.0

Requirimientos

No se necesitan bibliotecas externas para construir esta extensión

Instalación

Para usar las funciones de acceso directo a E/S, se debe añadir el parámetro --enable-dio a las opciones de configuración de PHP.

Constantes predefinidas

Estas constantes están definidas por esta extensión y estarán disponibles solamente cuando la extensión ha sido o bien compilada dentro de PHP o grabada dinámicamente en tiempo de ejecución.

c (integer)
F_DUPFD (integer)
F_GETFD (integer)
F_GETFL (integer)
F_GETLK (integer)
F_GETOWN (integer)
F_RDLCK (integer)
F_SETFL (integer)
F_SETLK (integer)
F_SETLKW (integer)
F_SETOWN (integer)
F_UNLCK (integer)
F_WRLCK (integer)
O_APPEND (integer)
O_ASYNC (integer)
O_CREAT (integer)
O_EXCL (integer)
O_NDELAY (integer)
O_NOCTTY (integer)
O_NONBLOCK (integer)
O_RDONLY (integer)
O_RDWR (integer)
O_SYNC (integer)
O_TRUNC (integer)
O_WRONLY (integer)
S_IRGRP (integer)
S_IROTH (integer)
S_IRUSR (integer)
S_IRWXG (integer)
S_IRWXO (integer)
S_IRWXU (integer)
S_IWGRP (integer)
S_IWOTH (integer)
S_IWUSR (integer)
S_IXGRP (integer)
S_IXOTH (integer)
S_IXUSR (integer)

Configuración en tiempo de ejecución

Esta extensión no tiene directivas de configuración en php.ini.

Tipos de recursos

La extensión de las funciones de acceso directo a E/S define un nuevo tipo de recurso: un descriptor de archivo devuelto por la función dio_open().

Tabla de contenidos
dio_close -- Cierra el descriptor de archivo indicado por el parámetro fd
dio_fcntl -- Realiza una operación del tipo fcntl de la librería de C sobre el descriptor de archivo indicado por el parámetro fd
dio_open -- Abre un archivo cuyo nombre indica el parámetro "nombre_archivo" con las opciones indicadas por "flags" y los permisos establecidos con "modo"
dio_read -- Lee bytes del archivo cuyo descriptor se pasa como parámetro.
dio_seek -- Cambia el posicionamiento en el archivo cuyo descriptor es fd a traves de los parámetros pos y whence
dio_stat -- Obtiene la información sobre el archivo cuyo descriptor es fd
dio_tcsetattr -- Configura las opciones de un terminal y la velocidad de un puerto serie
dio_truncate -- Trunca el tamaño del archivo cuyo descriptor es fd hasta un valor de offset bytes
dio_write -- Escribe datos en el archivo cuyo descriptor es fd