yaml_parse_file
(PECL yaml >= 0.4.0)
yaml_parse_file — Разбирает YAML-поток из файла
Описание
$filename
, int $pos = 0
, int &$ndocs = ?
, array $callbacks = null
) : mixedКонвертирует полностью или частично поток YAML-документов, читаемых из файла, в переменную PHP.
Список параметров
-
filename -
Путь к файлу.
-
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_url() - Разбирает YAML-поток из URL
- yaml_emit() - Возвращает YAML-представление значения