array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.eio-open.php', 1 => 'eio_open', ), 'up' => array ( 0 => 'ref.eio.php', 1 => 'Eio Функции', ), 'prev' => array ( 0 => 'function.eio-nthreads.php', 1 => 'eio_nthreads', ), 'next' => array ( 0 => 'function.eio-poll.php', 1 => 'eio_poll', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/eio/functions/eio-open.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PECL eio >= 0.0.1dev)
eio_open — Открывает файл
$path
,$flags
,$mode
,$pri
,$callback
,$data
= NULL
eio_open() открывает файл по заданному пути
path
в режиме доступа mode
.
path
Путь к открываемому файлу.
В некоторых SAPI (как, например, PHP-FPM) необходимо указывать полный путь. В противном случае произойдёт отказ в работе функции.
flags
Комбинация из одной или нескольких констант EIO_O_*.
Смысл констант EIO_O_* тот же, что и у соответствующих им
констант O_*, определённых в заголовочном файле С
fnctl.h
. По умолчанию принимается константа
EIO_O_RDWR
.
mode
Комбинация из одной или нескольких констант EIO_S_I* (через побитовое ИЛИ). Смысл констант тот же, что и у соответствующих им констант S_I*, определённых в заголовочном файле С » sys/stat.h. Параметр обязателен, если создаётся новый файл. В противном случае, параметр игнорируется.
pri
Приоритет запросов: EIO_PRI_DEFAULT
, EIO_PRI_MIN
, EIO_PRI_MAX
, или null
.
Если передан null
, то pri
устанавливается в
EIO_PRI_DEFAULT
.
callback
Функция callback
вызывается при завершении запроса.
Она должна удовлетворять следующему прототипу:
void callback(mixed $data, int $result[, resource $req]);
data
является пользовательскими данными, переданными в запросе.
result
содержит результирующее значение, зависящее от запроса; обычно это значение, возвращаемое соответствующим системным вызовом.
req
— необязательный запрашиваемый ресурс, который разрешено использовать с функциями наподобие eio_get_last_error().
data
Данные, которые будут передаваться в callback
-функцию.
eio_open() возвращает дескриптор файла через аргумент
result
callback-функции callback
.
В случае возникновения ошибки result
будет равен -1
.
Пример #1 Пример использования eio_open()
<?php
$temp_filename = "eio-temp-file.tmp";
/* Будет вызываться после завершения работы eio_close() */
function my_close_cb($data, $result) {
// Ноль указывает на успех операции
var_dump($result == 0);
@unlink($data);
}
/* Будет вызываться после завершения работы eio_open() */
function my_file_opened_callback($data, $result) {
// $result должен содержать дескриптор файла
var_dump($result > 0);
if ($result > 0) {
// закрываем файл
eio_close($result, EIO_PRI_DEFAULT, "my_close_cb", $data);
eio_event_loop();
}
}
// создаём файл для чтения и записи
// запрещаем группе и другим пользователям делать что-либо с файлом
eio_open($temp_filename, EIO_O_CREAT | EIO_O_RDWR, EIO_S_IRUSR | EIO_S_IWUSR,
EIO_PRI_DEFAULT, "my_file_opened_callback", $temp_filename);
eio_event_loop();
?>
Вывод приведённого примера будет похож на:
bool(true) bool(true)