tidy::parseString

tidy_parse_string

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

tidy::parseString -- tidy_parse_string — 文字列にストアされたドキュメントをパースする

説明

オブジェクト指向型

public tidy::parseString(string $string, array|string|null $config = null, ?string $encoding = null): bool

手続き型

tidy_parse_string(string $string, array|string|null $config = null, ?string $encoding = null): tidy|false

文字列にストアされたドキュメントをパースします。

パラメータ

string

パースするデータ。

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 です。

戻り値

新しい tidy インスタンスを返します。 tidy_parse_string() は、成功時に新しい tidy インスタンスを返します。これらのメソッド、関数は、失敗時に false を返します。

変更履歴

バージョン	説明
8.0.0	`config` と `encoding` は、nullable になりました。

例

例1 tidy::parseString() の例

<?php
ob_start();
?>

<html>
  <head>
   <title>test</title>
  </head>
  <body>
   <p>error<br>another line</i>
  </body>
</html>

<?php

$buffer = ob_get_clean();
$config = array('indent' => TRUE,
                'output-xhtml' => TRUE,
                'wrap' => 200);

$tidy = tidy_parse_string($buffer, $config, 'UTF8');

$tidy->cleanRepair();
echo $tidy;
?>

上の例の出力は以下となります。

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <title>
      test
    </title>
  </head>
  <body>
    <p>
      error<br />
      another line
    </p>
  </body>
</html>

参考

tidy::parseFile() - ファイルまたは URI にあるマークアップをパースする
tidy::repairFile() - ファイルを修正し、それを文字列として返す
tidy::repairString() - 別途提供される設定ファイルを使用して文字列を修正する

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 3 notes

down

gbirch at tech-tamer dot com ¶

1 year ago

The configuration reference for Tidy has moved to https://api.html-tidy.org/

down

steven at nevvix dot com ¶

7 years ago

<?php/** * Simpler version without pretty print config options. */function tidy_html5($html, array $config = [], $encoding = 'utf8') {    $config += [        'doctype' => '<!DOCTYPE html>',        'drop-empty-elements' => 0,        'new-blocklevel-tags' => 'article aside audio bdi canvas details dialog figcaption figure footer header hgroup main menu menuitem nav section source summary template track video',        'new-empty-tags' => 'command embed keygen source track wbr',        'new-inline-tags' => 'audio command datalist embed keygen mark menuitem meter output progress source time video wbr',        'tidy-mark' => 0,    ];    $html = tidy_parse_string($html, $config, $encoding); // doctype not inserted    tidy_clean_repair($html); // doctype inserted    return $html;}$html = '</z><p><a href="#">Link</a></p><p><img src="logo.png"/>Seçond para</p><i class="fa"></i><p></p>';echo tidy_html5($html);<!DOCTYPE html><html><head><title></title></head><body><p><a href="#">Link</a></p><p><img src="logo.png">Seçond para</p><i class="fa"></i><p></p></body></html>echo tidy_html5($html, ['indent'=>2, 'indent-spaces'=>4]);<!DOCTYPE html><html><head>    <title></title></head><body>    <p><a href="#">Link</a></p>    <p><img src="logo.png">Seçond para</p><i class="fa"></i>    <p></p></body></html>echo tidy_html5($html, ['indent'=>1], 'ascii');<!DOCTYPE html><html>  <head>    <title></title>  </head>  <body>    <p>      <a href="#">Link</a>    </p>    <p>      <img src="logo.png">Se&Atilde;&sect;ond para    </p><i class="fa"></i>    <p></p>  </body></html>echo tidy_html5($html, ['show-body-only'=>1]);<p><a href="#">Link</a></p><p><img src="logo.png">Seçond para</p><i class="fa"></i><p></p>

down

steven at nevvix dot com ¶

7 years ago

<?php/*** UTF-8 HTML5-compatible Tidy** @param string $html* @param array $config* @param string $encoding* @link http://tidy.sourceforge.net/docs/quickref.html*/function tidy_html5($html, array $config = [], $encoding = 'utf8') {    $config += [        'clean'       => TRUE,        'doctype'     => 'omit',        'indent'      => 2, // auto        'output-html' => TRUE,        'tidy-mark'   => FALSE,        'wrap'        => 0,        // HTML5 tags        'new-blocklevel-tags' => 'article aside audio bdi canvas details dialog figcaption figure footer header hgroup main menu menuitem nav section source summary template track video',        'new-empty-tags' => 'command embed keygen source track wbr',        'new-inline-tags' => 'audio command datalist embed keygen mark menuitem meter output progress source time video wbr',    ];    $html = tidy_parse_string($html, $config, $encoding);    tidy_clean_repair($html);    return '<!DOCTYPE html>' . PHP_EOL . $html;}$html = '</z><p><a href="#">Link</a></p><p>Second para</p>';echo tidy_html5($html);Output:<!DOCTYPE html><html><head>  <title></title></head><body>  <p><a href="#">Link</a></p>  <p>Second para</p></body></html>

＋add a note