dio_open

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

dio_open 在 C 库输入/输出流函数允许的更低级别打开(必要时创建)文件

说明

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

dio_open() 打开文件并返回新的文件描述符。

参数

filename

要打开的文件路径。

flags

flags 参数是按位或运算值,包含以下列表的标志。 必须包含 O_RDONLYO_WRONLYO_RDWR 中的一个。此外,可以包含此列表中其它标志的任意组合。

  • O_RDONLY - 打开文件读访问。

  • O_WRONLY - 打开文件写访问。

  • O_RDWR - 打开文件读写。

  • O_CREAT - 如果文件不存在,创建文件。

  • O_EXCL - 如果同时设置了 O_CREATO_EXCL,并且文件已存在,dio_open() 将执行失败。

  • O_TRUNC - 如果文件存在且已打开写访问,将会被截断到 0 长度。

  • O_APPEND - 写操作在文件末尾写数据。

  • O_NONBLOCK - 设置非阻塞模式。

  • O_NOCTTY - 防止操作系统在打开 TTY 设备文件时将文件指定为进程的控制终端。

mode

如果 flags 包含 O_CREATmode 将设置文件权限(创建权限)。当 flags 指定了 O_CREAT 标志时,需要 mode 才能正确操作,否则将会被忽略。

分配给创建文件的实际权限照例受到进程的 umask 设置的影响。

返回值

文件描述符,错误时是 false

示例

示例 #1 打开文件描述符

<?php

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

dio_close($fd);
?>

参见