(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)