calcinai/php-mmap

mmap for PHP

v0.1.8 2016-08-01 09:05 UTC

Requires

• php: >=5.4.0

Suggests

• ext-mmap: Much more efficient native extension

MIT

• Michael Calcinai

README

This library is a lightweight implementation of c's mmap. In previous versions of PHP, fopen used mmap where possible, but it looks like this was dropped in 5.3. The actual mapping is delegated to a python subprocess for compatibility and compilability .

This started as a component of another project, but it made more sense for it to be stand alone. It is synchronous in operation, but if you're reading large amounts of data it can be done piece by piece.

I have tried to make it functionally equivalent to c's implementation, but it's not quite complete due to some limitations.

I have also written a compatible extension that you can compile and install as a faster drop-in replacement

Setup

Using composer:

  "require": {
  	"calcinai/php-mmap": "^0.1"
  }

Usage

Via a URI (of sorts)

    $mmap = fopen('mmap:///dev/mem:1024?offset=0', 'rw');

Via wrapper method

    $mmap = mmap_open('/dev/mem', 1024, 0);

You can use fseek(), fread() and fwrite() on the stream. If you have a use for others, let me know.