dio_open

(PHP 4 >= 4.2.0, PHP 5 < 5.1.0)

dio_open — Abre (crea si fuera necesario) un fichero a un nivel más bajo que el permitido por flujos de entrada y salida de las bibliotecas en C.

Descripción

dio_open ( string $filename , int $flags [, int $mode = 0 ] ) : resource

dio_open() abre un fichero y devuelve su descriptor de fichero.

Parámetros

filename

Ruta del fichero a abrir.

flags

El parámetro flags es una máscara OR de bits compuesta a partir de las siguientes banderas. Estos valores tienen que incluir alguno de entre O_RDONLY, O_WRONLY, o O_RDWR. Además, podría incluir cualquier combinación del resto de banderas de la lista.

  • O_RDONLY - abre el fichero con acceso de lectura.

  • O_WRONLY - abre el fichero con acceso de escritura.

  • O_RDWR - abre el fichero con acceso de lectura y de escritura.

  • O_CREAT - crea el fichero, si no existiera ya.

  • O_EXCL - si tanto O_CREAT como O_EXCL están habilitados, y el fichero existe, provoca que dio_open() falle.

  • O_TRUNC - si el fichero existe, y está abierto con sólo escritura, se truncará a cero.

  • O_APPEND - las operaciones de escritura añaden los datos al final del fichero.

  • O_NONBLOCK - asigna el modo no bloqueante.

  • O_NOCTTY - previene que el SO asigne al fichero abierto como el terminal controlador del proceso cuando se abra un fichero de dispositivo TTY.

modo

Si flags contiene O_CREAT, mode establecerá los permisos del ficher (permisos de creación). Mode es necesario para un correcto funcionamiento cuando O_CREAT se especifica en mode, y se ignorará en cualquier otro caso.

Los permisos que realmente se asignan al fichero creado se verán afectados por el umask del proceso, como suele suceder.

Valores devueltos

Descriptor de fichero o FALSE en caso de error.

Ejemplos

Ejemplo #1 Abrir un descriptor de fichero

<?php

$fd = dio_open('/dev/ttyS0', O_RDWR | O_NOCTTY | O_NONBLOCK);

dio_close($fd);
?>

Ver también