public static function Yaml::parse in Plug 7

Parses YAML into a PHP array.

The parse method, when supplied with a YAML stream (string or file), will do its best to convert YAML in a file into a PHP array.

Usage: <code> $array = Yaml::parse('config.yml'); print_r($array); </code>

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.

@api

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:

Return value

array The YAML converted to a PHP array

Throws

ParseException If the YAML is not valid

11 calls to Yaml::parse()

ParserTest::testEmptyValue in lib/Symfony/yaml/Symfony/Component/Yaml/Tests/ParserTest.php
ParserTest::testFoldedStringBlockWithComments in lib/Symfony/yaml/Symfony/Component/Yaml/Tests/ParserTest.php
ParserTest::testMappingDuplicateKeyBlock in lib/Symfony/yaml/Symfony/Component/Yaml/Tests/ParserTest.php: > It is an error for two equal keys to appear in the same mapping node. > In such a case the YAML processor may continue, ignoring the second > `key: value` pair and issuing an appropriate warning. This strategy > preserves a consistent…
ParserTest::testMappingDuplicateKeyFlow in lib/Symfony/yaml/Symfony/Component/Yaml/Tests/ParserTest.php: @covers \Symfony\Component\Yaml\Inline::parseMapping
ParserTest::testMappingInASequence in lib/Symfony/yaml/Symfony/Component/Yaml/Tests/ParserTest.php: @expectedException \Symfony\Component\Yaml\Exception\ParseException

... See full list

File

lib/Symfony/yaml/Symfony/Component/Yaml/Yaml.php, line 53

Class

Yaml: Yaml offers convenience methods to load and dump YAML.

Namespace

Symfony\Component\Yaml

Code

public static function parse($input, $exceptionOnInvalidType = false, $objectSupport = false) {

  // if input is a file, process it
  $file = '';
  if (strpos($input, "\n") === false && is_file($input)) {
    if (false === is_readable($input)) {
      throw new ParseException(sprintf('Unable to parse "%s" as the file is not readable.', $input));
    }
    $file = $input;
    $input = file_get_contents($file);
  }
  $yaml = new Parser();
  try {
    return $yaml
      ->parse($input, $exceptionOnInvalidType, $objectSupport);
  } catch (ParseException $e) {
    if ($file) {
      $e
        ->setParsedFile($file);
    }
    throw $e;
  }
}

You are here