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-представление значения