PHP Conference Japan 2024

tidy::parseFile

tidy_parse_file

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

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

Описание

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

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

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

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() - Восстанавливает строку, используя по возможности конфигурационный файл
Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top