dio_open
(PHP 4 >= 4.2.0, PHP 5 < 5.1.0)
dio_open — Открывает файл (по необходимости создает) на более низком уровне нежели потоковые функции ввода/вывода языка C
Описание
$filename
, int $flags
, int $mode
= 0
) : resourcedio_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
- если файл существует и был открыт на запись, то он будет обрезан до нулевой длины. -
O_APPEND
- операции записи будут происходить в конец файла. -
O_NONBLOCK
- установить неблокирующий режим. -
O_NOCTTY
- запрещает операционной системе считать открытый файл за терминал контроля процесса, если был открыт файл устройства TTY.
-
-
mode
-
Если
flags
содержитO_CREAT
,mode
установит разрешения для файла (creation permissions).mode
требуется для корректной работы в случае указанияO_CREAT
вflags
и в других случаях будет проигнорирован.Актуальные разрешения, которые будут присвоены созданному файлу, будут зависеть от настройки umask процесса, как обычно.
Возвращаемые значения
Файловый дескриптор или false
в случае возникновения ошибки.
Примеры
Пример #1 Открытие файлового дескриптора
<?php
$fd = dio_open('/dev/ttyS0', O_RDWR | O_NOCTTY | O_NONBLOCK);
dio_close($fd);
?>