Разбирает разметку в файле или URI-идентификаторе

# tidy::parseFile

# tidy_parse_file

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

tidy::parseFile -- tidy_parse_file — Разбирает разметку в файле или URI-идентификаторе

### Описание

Объектно-ориентированный стиль

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

Процедурный стиль

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

Функция разбирает файл.

### Список параметров

`filename`

  С параметром `filename` функция считает этот файл и инициализирует объект с этим файлом. Функция действует аналогично функции tidy_parse_file().

`config`

  В аргументе `config` передают массив или строку. Функция интерпретирует строку как название файла конфигурации, а массив как сами параметры.

  Объяснение параметров доступно по ссылке: » http://api.html-tidy.org/#quick-reference.

`encoding`

  Параметр `encoding` устанавливает кодировку для входных и выходных документов. Параметр принимает значения: `ascii`, `latin0`, `latin1`, `raw`, `utf8`, `iso2022`, `mac`, `win1252`, `ibm858`, `utf16`, `utf16le`, `utf16be`, `big5` и `shiftjis`.

`useIncludePath`

  Параметр выполняет поиск файла в списке путей директивы include_path.

### Возвращаемые значения

В случае успешного выполнения метод tidy::parseFile() возвращает `true`. Функция tidy_parse_file() в случае успешного выполнения возвращает новый экземпляр tidy. И метод, и функция возвращают `false`, если возникла ошибка.

### Список изменений

Версия | Описание
--- | ---
8.0.0 | Параметры `config` и `encoding` теперь принимают значение `null`.

### Примеры

Пример #1 Пример разбора файла методом tidy::parseFile()

    <?php

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

    $tidy->cleanRepair();

    if (!empty($tidy->errorBuffer)) {
        echo "Возникли следующие ошибки или предупреждения:\n";
        echo $tidy->errorBuffer;
    }

    ?>

### Смотрите также

- tidy::parseString() - Разбор документа, хранимого в строке
- tidy::repairFile() - Восстанавливает разметку файла и возвращает его в виде строки
- tidy::repairString() - Восстанавливает строку, используя по возможности конфигурационный файл

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