# tidy::parseFile

# tidy_parse_file

(PHP 5, PHP 7, PHP 8, PECL tidy >= 0.5.2)

tidy::parseFile -- tidy_parse_file — Analiza las etiquetas de un fichero o URI

### Descripción

Estilo orientado a objetos

public tidy::parseFile(
string `$filename`,
array|string|null `$config` = `null`,
?string `$encoding` = `null`,
bool `$useIncludePath` = `false`
): bool

Estilo por procedimientos

tidy_parse_file(
string `$filename`,
array|string|null `$config` = `null`,
?string `$encoding` = `null`,
bool `$useIncludePath` = `false`
): tidy|false

Analiza el fichero especificado.

### Parámetros

`filename`

  Si el parámetro `filename` es indicado, esta función también leerá ese fichero e iniciará el objeto con el fichero, actuando como tidy_parse_file().

`config`

  La configuración `config` puede ser pasada en forma de un array o un string. Si un string es pasado, será interpretado como el el nombre del fichero de configuración, de otra forma, será interpretado como opciones en sí mismas.

  Para una explicación de cada opción, consulte » http://api.html-tidy.org/#quick-reference.

`encoding`

  El parámetro `encoding` establece la codificación para entarda/salida de los documentos. Los posibles valores de codificación son: `ascii`, `latin0`, `latin1`, `raw`, `utf8`, `iso2022`, `mac`, `win1252`, `ibm858`, `utf16`, `utf16le`, `utf16be`, `big5`, y `shiftjis`.

`useIncludePath`

  Busca el fichero en el include_path.

### Valores devueltos

tidy::parseFile() returns `true` on success. tidy_parse_file() returns a new tidy instance on success. Both, the method and the function return `false` on failure.

### Historial de cambios

Versión | Descripción
--- | ---
8.0.0 | `config` and `encoding` are nullable now.

### Ejemplos

Ejemplo #1 Ejemplo de tidy::parseFile()

`<?php
$tidy = new tidy();
$tidy->parseFile('file.html');
$tidy->cleanRepair();
if(!empty($tidy->errorBuffer)) {
echo "Los siguientes errores o advertencias ocurrieron:\n";
echo $tidy->errorBuffer;
}
?>`

### Ver también

- tidy::parsestring() - Analiza un documento almacenado en una cadena
- tidy::repairfile() - Repara un archivo y lo devuelve como una cadena
- tidy::repairstring() - Repara una cadena HTML usando un archivo de configuración opcional