大网数据广告活动
PHP 语言与运行手册

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

· 52CE 我爱测

flags 参数是按位或运算值,包含以下列表的标志。 必须包含 O_RDONLY、O_WRONLY 或 O_RDWR 中的一个。此外,可以包含此列表中其它标志的任意组合。 O_RDONLY - 打开文件读访问。

dio_open

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

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

说明

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

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

参数

filename

要打开的文件路径。

flags

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

  • O_RDONLY - 打开文件读访问。

  • O_WRONLY - 打开文件写访问。

  • O_RDWR - 打开文件读写。

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

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

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

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

  • O_NONBLOCK - 设置非阻塞模式。

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

mode

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

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

返回值

文件描述符,错误时是 false。

示例

示例 #1 打开文件描述符

<?php

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

dio_close($fd);
?>

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。