Yaml

class Yaml

Yaml offers convenience methods to load and dump YAML.

Methods

static mixed parse(string $input, bool $exceptionOnInvalidType = false, bool $objectSupport = false, bool $objectForMap = false)

Parses YAML into a PHP value.

static string dump(mixed $input, int $inline = 2, int $indent = 4, bool $exceptionOnInvalidType = false, bool $objectSupport = false)

Dumps a PHP value to a YAML string.

Details

static mixed parse(string $input, bool $exceptionOnInvalidType = false, bool $objectSupport = false, bool $objectForMap = false)

Parses YAML into a PHP value.

Usage: $array = Yaml::parse(filegetcontents('config.yml')); print_r($array);

As this method accepts both plain strings and file names as an input, you must validate the input before calling this method. Passing a file as an input is a deprecated feature and will be removed in 3.0.

Note: the ability to pass file names to the Yaml::parse method is deprecated since version 2.2 and will be removed in 3.0. Pass the YAML contents of the file instead.

Parameters

string $input Path to a YAML file or a string containing YAML
bool $exceptionOnInvalidType True if an exception must be thrown on invalid types false otherwise
bool $objectSupport True if object support is enabled, false otherwise
bool $objectForMap True if maps should return a stdClass instead of array()

Return Value

mixed The YAML converted to a PHP value

Exceptions

ParseException If the YAML is not valid

static string dump(mixed $input, int $inline = 2, int $indent = 4, bool $exceptionOnInvalidType = false, bool $objectSupport = false)

Dumps a PHP value to a YAML string.

The dump method, when supplied with an array, will do its best to convert the array into friendly YAML.

Parameters

mixed $input The PHP value
int $inline The level where you switch to inline YAML
int $indent The amount of spaces to use for indentation of nested nodes
bool $exceptionOnInvalidType true if an exception must be thrown on invalid types (a PHP resource or object), false otherwise
bool $objectSupport true if object support is enabled, false otherwise

Return Value

string A YAML string representing the original PHP value

© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/2.7/Symfony/Component/Yaml/Yaml.html