PHP Conference Nagoya 2025

    eio_read

    (PECL eio >= 0.0.1dev)

    eio_read — Читает данные из файла, начиная с заданного смещения

    Описание

    eio_read(
        mixed $fd,
        int $length,
        int $offset,
        int $pri,
        callable $callback,
        mixed $data = NULL
    ): resource

    eio_read() считывает length байт из файла с описателем fd, начиная с байта offset. Прочитанные данные передаются через параметр result в функцию callback.

    Список параметров

    fd

    Поток, ресурс сокета или числовой файловый описатель.

    length

    Максимальное считываемое число байт.

    offset

    Смещение в файле.

    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_read() передаёт считанные данные через параметр result в функцию callback.

    Примеры

    Пример #1 Пример использования eio_read()

    <?php
    // Открываем временный файл и пишем в него какие-либо данные
    $temp_filename = "eio-temp-file.tmp";
    $fp = fopen($temp_filename, "w");
    fwrite($fp, "1234567890");
    fclose($fp);

    /* Вызывается, когда eio_read() завершает работу */
    function my_read_cb($data, $result) {
    global     $temp_filename;

    // Выводим прочитанные данные
    var_dump($result);

    // закрываем файл
    eio_close($data);
    eio_event_loop();

    // Удаляем временный файл
    @unlink($temp_filename);
    }

    /* Вызывается, когда eio_open() завершает работу */
    function my_file_opened_callback($data, $result) {
    // $result должен содержать файловый описатель
    if ($result > 0) {
    // Прочитаем 5 байт, начиная с третьего
    eio_read($result, 5, 2, EIO_PRI_DEFAULT, "my_read_cb", $result);
    eio_event_loop();
    } else {
    // eio_open() завершила работу отказом
    unlink($data);
    }
    }

    // открываем файл для чтения и записи
    eio_open($temp_filename, EIO_O_RDWR, NULL,
    EIO_PRI_DEFAULT, "my_file_opened_callback", $temp_filename);
    eio_event_loop();
    ?>

    Вывод приведённого примера будет похож на: 

    string(5) "34567"

    Смотрите также

    • eio_open() - Открывает файл
    • eio_write() - Запись в файл
    • eio_close() - Закрыть файл
    • eio_event_loop() - Взаимодействует с libeio до тех пор, пока все запросы не будут выполнены

    Нашли ошибку?

    Инструкция • Исправление • Сообщение об ошибке
    ＋Добавить

    Примечания пользователей

    Пользователи ещё не добавляли примечания для страницы
    To Top