Analisar marcação em arquivo ou URI

# tidy::parseFile

# tidy_parse_file

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

tidy::parseFile -- tidy_parse_file — Analisar marcação em arquivo ou URI

### Descrição

Estilo orientado a objetos

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

Estilo procedural

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

Analisa o arquivo fornecido.

### Parâmetros

`filename`

  Se o parâmetro `filename` for fornecido, esta função também lerá esse arquivo e inicializará o objeto com o arquivo, agindo como tidy_parse_file().

`config`

  O parâmetro de configuração `config` pode ser passado como um array ou como uma string. Se uma string for passada, ela será interpretada como o nome do arquivo de configuração; caso contrário, será interpretada como as próprias opções.

  Para uma explicação sobre cada opção, consulte » http://api.html-tidy.org/#quick-reference.

`encoding`

  O parâmetro `encoding` define a codificação para documentos de entrada/saída. Os valores possíveis para codificação são: `ascii`, `latin0`, `latin1`, `raw`, `utf8`, `iso2022`, `mac`, `win1252`, `ibm858`, `utf16`, `utf16le`, `utf16be`, `big5` e `shiftjis`.

`useIncludePath`

  Procura o arquivo no include_path.

### Valor Retornado

tidy::parseFile() retorna `true` em caso de sucesso. tidy_parse_file() retorna uma nova instância de tidy em caso de sucesso. Tanto o método quanto a função retornam `false` em caso de falha.

### Registro de Alterações

Versão | Descrição
--- | ---
8.0.0 | `config` e `encoding` agora podem ser anulados.

### Exemplos

Exemplo #1 Exemplo de tidy::parseFile()

    <?php
    $tidy = new tidy();
    $tidy->parseFile('file.html');

    $tidy->cleanRepair();

    if(!empty($tidy->errorBuffer)) {
        echo "Os seguintes erros ou avisos ocorreram:\n";
        echo $tidy->errorBuffer;
    }
    ?>

### Veja Também

- tidy::parseString() - Analisa um documento armazenado em uma string
- tidy::repairFile() - Repara um arquivo e o retorna como uma string
- tidy::repairString() - Repara uma string usando um arquivo de configuração fornecido opcionalmente

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open