• 3 heads
  • 2 releases
  • git clone https://klva.cz/src/php/memory-stream.git
  • Added destructor listener. 947c127, 24 Apr 2022

    FFI memory stream wrapper

    This library provides a PHP stream wrapper for direct memory access using standard stream functions. It's intended to be used by FFI wrappers as a method of providing safe, convenient and known way of accessing data.


    composer install adawolfa/ffi-memory-stream


    There's a memory_open() function, which creates a stream to the data from FFI pointer.

    $ptr    = $ffi->get_buffer($size);
    $stream = Adawolfa\MemoryStream\memory_open($ptr, 'r', $size);
    $data   = fread($stream, 10);

    You can make the stream read-only (r), write-only (w) or unrestricted (rw). The wrapper ensures that the user operates within the stream boundaries thanks to the $size argument, which is mandatory.

    You, as a callee, should fclose() the stream explicitly once the pointer becomes invalid. Reading from or writing into such stream emits a warning, but unlike accessing the data via an invalid pointer, doesn't cause the process to crash, making it much easier for caller to debug.

    Both 32-bit and 64-bit platforms are supported, little-endian is assumed.