tidy::parseFile
tidy_parse_file
(PHP 5, PHP 7, PECL tidy >= 0.5.2)
tidy::parseFile -- tidy_parse_file — Разбор разметки в файле или URI
Описание
Объектно-ориентированный стиль
$filename
, array|string|null $config
= null
, string|null $encoding
= null
, bool $useIncludePath
= false
) : boolПроцедурный стиль
$filename
, array|string|null $config
= null
, string|null $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() - Восстанавливает строку, используя по возможности конфигурационный файл