@@ -185,7 +185,10 @@ If you only need to dump one array, you can use the
185185
186186 use Symfony\Component\Yaml\Yaml;
187187
188- $yaml = Yaml::dump($array, $inline);
188+ $yaml = Yaml::dump($array);
189+
190+
191+ ............................
189192
190193The YAML format supports two kind of representation for arrays, the expanded
191194one, and the inline one. By default, the dumper uses the inline
@@ -219,6 +222,49 @@ representation to the inline one:
219222foo :bar
220223bar :baz
221224
225+
226+ """""""""""
227+
228+ By default the YAML component will use 4 spaces for indentation. This can be
229+ changed using the second argument as follows::
230+
231+ // use 8 spaces for indentation
232+ echo Yaml::dump($array, 2, 8);
233+
234+ ..code-block ::yaml
235+
236+ foo :bar
237+ bar :
238+ foo :bar
239+ bar :baz
240+
241+
242+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
243+
244+ By default the YAML component will encode any "unsupported" type (i.e.
245+ resources and objects) as ``null ``.
246+
247+ Instead of encoding as ``null `` you can choose to throw an exception if an invalid
248+ type is encountered in either the dumper or parser as follows::
249+
250+ // throw an exception if a resource or object is encoutered
251+ $dumper->dump($data, 2, 4, true);
252+
253+ // throw an exception if an encoded object is found in the YAML string
254+ $parser->parse($yaml, true);
255+
256+ However, you can activate object support using the next argument::
257+
258+ $object = new \stdClass();
259+ $object->hello = 'goodbye';
260+
261+ $dumped = $dumper->dump($object, 2, 0, false, true);
262+ // !!php/object:O:8:"stdClass":1:{s:5:"hello";s:7:"goodbye";}
263+
264+ $parsed = $parser->parse($dumped, false, true);
265+ var_dump(is_object($parsed)); // true
266+ echo $parsed->hello; // goodbye
267+
222268.. _YAML :http://yaml.org/
223269.. _Packagist :https://packagist.org/packages/symfony/yaml
224270.. _`YAML 1.2 version specification` :http://yaml.org/spec/1.2/spec.html