Symfony Yaml

https://github.com/symfony/yaml
Admin
Symfony Yaml is a PHP library that loads and dumps YAML files, allowing applications to parse and...
Tokens:562
Snippets:10
Trust Score:9.5
License:MIT
Update:3 months ago
Show doc for...
Tokens:
Raw
### Parse Tagged Scalars

Source: https://github.com/symfony/yaml/blob/8.2/CHANGELOG.md

Example of parsing a custom tag using the Yaml::PARSE_CUSTOM_TAGS flag.

```yaml
Yaml::parse('!foo bar', Yaml::PARSE_CUSTOM_TAGS);
// returns TaggedValue('foo', 'bar');
```

--------------------------------

### Parsing non-string mapping keys

Source: https://github.com/symfony/yaml/blob/8.2/CHANGELOG.md

Demonstrates the transition from implicit non-string keys to explicit string keys using quotes.

```php
$yaml = <<<YAML
null: null key
true: boolean true
2.0: float key
YAML;

Yaml::parse($yaml);
```

```php

$yaml = <<<YAML
"null": null key
"true": boolean true
"2.0": float key
YAML;

Yaml::parse($yaml);
```

--------------------------------

### Parse Octal Numbers

Source: https://github.com/symfony/yaml/blob/8.2/CHANGELOG.md

Demonstrates the transition from legacy octal parsing to the explicit '0o' prefix format.

```yaml
Yaml::parse('072');
```

```yaml
Yaml::parse('0o72');
```

--------------------------------

### Dumping empty arrays as sequences

Source: https://github.com/symfony/yaml/blob/8.2/CHANGELOG.md

Configures the dumper to represent empty PHP arrays as YAML sequences.

```php
Yaml::dump([], 0, 0, Yaml::DUMP_EMPTY_ARRAY_AS_SEQUENCE);
```

--------------------------------

### Customizing dumper behavior

Source: https://github.com/symfony/yaml/blob/8.2/CHANGELOG.md

Uses a bit field to configure specific dumping behaviors for objects and invalid types.

```php
Yaml::dump(['foo' => new A(), 'bar' => 1], 0, 0, Yaml::DUMP_EXCEPTION_ON_INVALID_TYPE | Yaml::DUMP_OBJECT);
```

--------------------------------

### Customizing parser behavior

Source: https://github.com/symfony/yaml/blob/8.2/CHANGELOG.md

Uses a bit field to configure specific parsing behaviors for objects and invalid types.

```php
Yaml::parse('{ "foo": "bar", "fiz": "cat" }', Yaml::PARSE_EXCEPTION_ON_INVALID_TYPE | Yaml::PARSE_OBJECT | Yaml::PARSE_OBJECT_FOR_MAP);
```

--------------------------------

### Parsing PHP constants

Source: https://github.com/symfony/yaml/blob/8.2/CHANGELOG.md

Enables the parser to resolve PHP constants using the PARSE_CONSTANT flag.

```php
Yaml::parse('!php/const:PHP_INT_MAX', Yaml::PARSE_CONSTANT);
```

--------------------------------

### Parsing timestamps as DateTime objects

Source: https://github.com/symfony/yaml/blob/8.2/CHANGELOG.md

Configures the parser to return DateTime objects instead of strings for timestamp values.

```php
Yaml::parse('2001-12-15 21:59:43.10 -5', Yaml::PARSE_DATETIME);
```

--------------------------------

### Escaping backslashes in double-quoted strings

Source: https://github.com/symfony/yaml/blob/8.2/CHANGELOG.md

Shows the requirement to escape backslashes within double-quoted YAML strings.

```yml
class: "Foo\Var"
```

```yml
class: "Foo\\Var"
```
Tokens:
Raw