ffi/var-dumper

List of symfony/var-dumper casters with FFI support

Maintainers

Details

github.com/php-ffi/var-dumper

Source

Issues

Documentation

Installs: 2 928

Dependents: 1

Suggesters: 0

Security: 0

Stars: 19

Watchers: 1

Forks: 0

Open Issues: 0

1.0.2 2024-08-14 21:01 UTC

Requires

Requires (Dev)

MIT 77eed693f3833c21ee4c5f9a1c63fbaaa500cc52

symfonyvar-dumpercastersffi

This package is auto-updated.

Last update: 2024-11-14 21:40:09 UTC

README

PHP 8.1+ Latest Stable Version Latest Unstable Version Total Downloads License MIT

This library allows you to dump FFI types using the functions dd() and dump().

Requirements

  • PHP >= 8.1

Installation

Library is available as composer repository and can be installed using the following command in a root of your project.

$ composer require ffi/var-dumper

Usage

dump(\FFI::new('struct { float x }'));

//
// Expected Output:
//
// struct <anonymous> {
//   x<float>: 0.0
// }
//

Unsafe Access

Some values may contain data that will cause access errors when read. For example, pointers leading to "emptiness".

Such data is marked as "unsafe" and only the first element is displayed. If you want to display the values in full, you should use the VAR_DUMPER_FFI_UNSAFE=1 environment variable.

// Create char* with "Hello World!\0" string.
$string = \FFI::new('char[13]');
\FFI::memcpy($string, 'Hello World!', 12);
$pointer = \FFI::cast('char*', $string);

// Dump
dump($pointer);

// VAR_DUMPER_FFI_UNSAFE=0
//
// > char* (unsafe access) {
// >  +0: "H"
// > }

// VAR_DUMPER_FFI_UNSAFE=1
//
// > b"Hello World!\x00"