eio_open

PECL eio >= 0.0.1dev
eio_open - Opens a file
Manual
Code Examples

eio_open(
     string$path,
     int$flags,
     int$mode,
     int$pri,
     callable$callback,
     [mixed$data = NULL]
): resource

eio_open opens file specified by path in access mode mode with

Parameters

path

Path of the file to be opened.

Warning:

In some SAPIs(e.g. PHP-FPM) it could fail, if you don't specify full path.

flags

One of EIO_O_* constants, or their combinations. EIO_O_* constants have the same meaning, as their corresponding O_* counterparts defined in fnctl.h C header file. Default is EIO_O_RDWR.

mode

One of EIO_S_I* constants, or their combination (via bitwise OR operator). The constants have the same meaning as their S_I* counterparts defined in sys/stat.h C header file. Required, if a file is created. Otherwise ignored.

pri

The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or null. If null passed, pri internally is set to EIO_PRI_DEFAULT.

callback

callback function is called when the request is done. It should match the following prototype:

void callback(mixed $data, int $result[, resource $req]);
data

is custom data passed to the request.

result

request-specific result value; basically, the value returned by corresponding system call.

req

is optional request resource which can be used with functions like eio_get_last_error

data

Arbitrary variable passed to callback.

Return Values

eio_open returns file descriptor in result argument of callback on success; otherwise, result is equal to -1.

Related Functions

Example of eio_open

Show all examples for eio_open

PHP Version: