# yaml_parse_file

(PECL yaml >= 0.4.0)

yaml_parse_file — Analiza una secuencia de texto en formato YAML desde un fichero

### Descripción

yaml_parse_file(
string `$filename`,
int `$pos` = 0,
int `&$ndocs` = ?,
array `$callbacks` = `null`
): mixed

Convierte toda o parte de una secuencia de texto en YAML a una variable en PHP.

### Parámetros

`filename`

  Ruta del nombre del fichero.

`pos`

  Documento YAML a extraer desde la secuencia de texto (`-1` para analizar todos los documentos, `0` solo para el primer documento, etc).

`ndocs`

  Si se facilita `ndocs`, se completará con el número de documentos encontrados en la secuencia de texto.

`callbacks`

  Controlador de contenido para los nodos YAML. Es un array associativo de etiquetas YAML => asociando sus callback correspondientes. Ver Analizar callbacks para más información.

### Valores devueltos

Devuelve el valor codificado de `input` en el formato apropiado de PHP o `false` en caso de error. Si el valor de `pos` es `-1` devolverá un array con una entrada por cada documento encontrado en el texto.

### Notas

Advertencia

El procesamiento de las entradas de los usuarios no confiables con yaml_parse_file() es peligroso si el uso de unserialize() está habilitado para los nodos usando la etiqueta `!php/object`. Este comportamiento puede ser desactivado por el uso de el ajuste ini `yaml.decode_php`.

### Ver también

- yaml_parse() - Analiza una secuencia de texto en formato YAML
- yaml_parse_url() - Analiza una secuencia de texto Yaml desde una URL
- yaml_emit() - Devuelve la representación de un valor YAML