array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.yaml-parse.php', 1 => 'yaml_parse', 2 => 'Analisa um fluxo YAML', ), 'up' => array ( 0 => 'ref.yaml.php', 1 => 'Funções de Yaml', ), 'prev' => array ( 0 => 'function.yaml-emit-file.php', 1 => 'yaml_emit_file', ), 'next' => array ( 0 => 'function.yaml-parse-file.php', 1 => 'yaml_parse_file', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/yaml/functions/yaml-parse.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

yaml_parse

(PECL yaml >= 0.4.0)

yaml_parse — Analisa um fluxo YAML

Descrição

yaml_parse(
    string $input,
    int $pos = 0,
    int &$ndocs = ?,
    array $callbacks = null
): mixed

Converte todo ou parte de um fluxo de documentos YAML em uma variável PHP.

Parâmetros

input

A string a ser analisada como um fluxo de documentos YAML.

pos

Documento a ser extraído do fluxo (-1 para todos os documentos, 0 para o primeiro documento, ...).

ndocs

Se ndocs for fornecido, será preenchido com o número de documentos encontrados no fluxo.

callbacks

Manipuladores de conteúdo para nós YAML. Um array associativo para mapeamento de etiqueta => callable. Consulte funções de análise para mais detalhes.

Valor Retornado

Retorna o valor codificado em input no tipo PHP apropriado ou false em caso de falha. Se pos for -1, um array será retornado com uma entrada para cada documento encontrado no fluxo.

Exemplos

Exemplo #1 Exemplo de yaml_parse()

<?php
$yaml = <<<EOD
---
invoice: 34843
date: "2001-01-23"
bill-to: &id001
given: Chris
family: Dumars
address:
lines: |-
458 Walkman Dr.
Suite #292
city: Royal Oak
state: MI
postal: 48046
ship-to: *id001
product:
- sku: BL394D
quantity: 4
description: Basketball
price: 450
- sku: BL4438H
quantity: 1
description: Super Hoop
price: 2392
tax: 251.420000
total: 4443.520000
comments: Late afternoon is best. Backup contact is Nancy Billsmer @ 338-4338.
...
EOD;

$parsed = yaml_parse($yaml);
var_dump($parsed);
?>

O exemplo acima produzirá algo semelhante a:

array(8) {
  ["invoice"]=>
  int(34843)
  ["date"]=>
  string(10) "2001-01-23"
  ["bill-to"]=>
  &array(3) {
    ["given"]=>
    string(5) "Chris"
    ["family"]=>
    string(6) "Dumars"
    ["address"]=>
    array(4) {
      ["lines"]=>
      string(34) "458 Walkman Dr.
        Suite #292"
      ["city"]=>
      string(9) "Royal Oak"
      ["state"]=>
      string(2) "MI"
      ["postal"]=>
      int(48046)
    }
  }
  ["ship-to"]=>
  &array(3) {
    ["given"]=>
    string(5) "Chris"
    ["family"]=>
    string(6) "Dumars"
    ["address"]=>
    array(4) {
      ["lines"]=>
      string(34) "458 Walkman Dr.
        Suite #292"
      ["city"]=>
      string(9) "Royal Oak"
      ["state"]=>
      string(2) "MI"
      ["postal"]=>
      int(48046)
    }
  }
  ["product"]=>
  array(2) {
    [0]=>
    array(4) {
      ["sku"]=>
      string(6) "BL394D"
      ["quantity"]=>
      int(4)
      ["description"]=>
      string(10) "Basketball"
      ["price"]=>
      int(450)
    }
    [1]=>
    array(4) {
      ["sku"]=>
      string(7) "BL4438H"
      ["quantity"]=>
      int(1)
      ["description"]=>
      string(10) "Super Hoop"
      ["price"]=>
      int(2392)
    }
  }
  ["tax"]=>
  float(251.42)
  ["total"]=>
  float(4443.52)
  ["comments"]=>
  string(68) "Late afternoon is best. Backup contact is Nancy Billsmer @ 338-4338."
}

Notas

Aviso

Processar entradas não confiáveis de usuários ​​com yaml_parse() é perigoso se o uso de unserialize() estiver habilitado para nós que usam a etiqueta !php/object. Este comportamento pode ser desativado usando a configuração INI yaml.decode_php.

Veja Também