tysonandre/var_representation_polyfill

Polyfill for var_representation: convert a variable to a string in a way that fixes the shortcomings of var_export

Maintainers

Details

github.com/TysonAndre/var_representation_polyfill

Source

Issues

Installs: 4 147 581

Dependents: 2

Suggesters: 0

Security: 0

Stars: 14

Watchers: 3

Forks: 2

Open Issues: 1

0.1.3 2022-08-31 12:59 UTC

Requires

  • php: ^7.2.0|^8.0.0
  • ext-tokenizer: *

Requires (Dev)

Suggests

Provides

MIT e9116c2c352bb0835ca428b442dde7767c11ad32

  • Tyson Andre

var_exportvar_representation

This package is auto-updated.

Last update: 2024-11-29 06:52:49 UTC

README

Build Status License Latest Stable Version

var_representation_polyfill is a polyfill for https://pecl.php.net/var_representation

This provides a polyfill for the function var_representation(mixed $value, int $flags = 0): string, which converts a variable to a string in a way that fixes the shortcomings of var_export()

See the var_representation PECL documentation for more details

Installation

composer require tysonandre/var_representation_polyfill

Usage

// uses short arrays, and omits array keys if array_is_list() would be true
php > echo var_representation(['a','b']);
[
  'a',
  'b',
]

// can dump everything on one line.
php > echo var_representation(['a', 'b', 'c'], VAR_REPRESENTATION_SINGLE_LINE);
['a', 'b', 'c']

php > echo var_representation("uses double quotes: \$\"'\\\n");
"uses double quotes: \$\"'\\\n"

// Can disable the escaping of control characters as of polyfill version 0.1.0
// (e.g. if the return value needs to be escaped again)
php > echo var_representation("has\nnewlines", VAR_REPRESENTATION_UNESCAPED);
'has
newlines'
php > echo json_encode("uses single quotes:\0\r\n\$\"'\\");
"uses single quotes:\u0000\r\n$\"'\\"
php > echo json_encode(var_representation("uses single quotes:\0\r\n\$\"'\\",
                                          VAR_REPRESENTATION_UNESCAPED));
"'uses single quotes:\u0000\r\n$\"\\'\\\\'"