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, а значения callback-функциями (callable), которые будут их обрабатывать. Более подробно этот механизм описан в разделе callback-функции разбора.

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

Возвращает значение, закодированное в input, в соответствующем PHP типе или FALSE в случае возникновения ошибки. Если параметр pos равен -1, то будет возвращен массив (array), содержащий по одной записи для каждого документа, найденного в потоке.

Примечания

Внимание

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

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

  • yaml_parse() - Разбирает поток YAML
  • yaml_parse_file() - Разбирает YAML-поток из файла
  • yaml_emit() - Возвращает YAML-представление значения