PHPのお勉強！

PHP TOP
PHP 8.4.2 Released!

    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

    up
    1
    steven at nevvix dot com
    6 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>
    up
    0
    gbirch at tech-tamer dot com
    6 months ago
    The configuration reference for Tidy has moved to https://api.html-tidy.org/
    up
    0
    steven at nevvix dot com
    6 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
    To Top