array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.yaml-parse-url.php', 1 => 'yaml_parse_url', 2 => 'Разбирает YAML-поток по URL-адресу', ), 'up' => array ( 0 => 'ref.yaml.php', 1 => 'Функции Yaml', ), 'prev' => array ( 0 => 'function.yaml-parse-file.php', 1 => 'yaml_parse_file', ), 'next' => array ( 0 => 'book.yaf.php', 1 => 'Yaf', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/yaml/functions/yaml-parse-url.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

yaml_parse_url

(PECL yaml >= 0.4.0)

yaml_parse_url — Разбирает YAML-поток по URL-адресу

Описание

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

Функция преобразовывает поток или часть потока YAML-документа, который считывает по URL-адресу, в переменную PHP.

Список параметров

url

Параметр url принимает адрес в форме "scheme://...". PHP найдёт обработчик протокола, или обёртку, для этой схемы. PHP сгенерирует уведомление, которое помогает отслеживать потенциальные проблемы в скрипте, а затем продолжит работу, как если бы название файла указывало на обыкновенный файл, если обёртку для этого протокола не зарегистрировали.

pos

Индекс документа для извлечения из потока: -1 для всех документов, 0 для первого документа и т. д.

ndocs

Функция заполнит переменную, которую передали в аргументе ndocs, количеством документов, которое функция нашла в потоке.

callbacks

Обработчики содержимого YAML-узлов. Ассоциативный массив (array), в котором ключи — YAML-теги, а значения — callable-выражения, которые сопоставляются с тегами. Подробнее этот механизм описывает раздел callback-функции разбора.

Возвращаемые значения

Функция возвращает закодированное в аргументе url значение как PHP-тип, который соответствует значению, или false, если возникла ошибка. Функция вернёт массив (array), который будет содержать одну запись для каждого документа, который функция нашла в потоке, если параметр pos равен -1.

Примечания

Внимание

Обработка ненадёжного пользовательского ввода функцией yaml_parse_file() представляет опасность, если для узлов с тегом !php/object разрешили вызывать функцию unserialize(). Такое поведение отключают ini-настройкой yaml.decode_php.

Смотрите также