repo_zf1/documentation/manual/ja/module_specs/Zend_Validate-Sitemap.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 24249 -->
<sect2 id="zend.validate.sitemap">
    <title>サイトマップ・バリデータ</title>

    <para>
        以下のバリデータは、
        <ulink url="http://www.sitemaps.org/protocol.php">サイトマップ <acronym>XML</acronym> プロトコル</ulink>
        に従います。
    </para>

    <sect3 id="zend.validate.sitemap.changefreq">
        <title>Sitemap_Changefreq</title>

        <para>
            文字列がサイトマップ <acronym>XML</acronym> 文書で 'changefreq' 要素として
            使用できるかどうか検証します。
            有効値は、 'always', 'hourly', 'daily', 'weekly', 'monthly', 'yearly' または 'never' です。
        </para>

        <para>
            値が文字列で、上記で指定される頻度のうちの1つと等しい場合に限り、
            <constant>TRUE</constant>を返します。
        </para>
    </sect3>

    <sect3 id="zend.validate.sitemap.lastmod">
        <title>Sitemap_Lastmod</title>

        <para>
            文字列がサイトマップ <acronym>XML</acronym> 文書で 'lastmod' 要素として
            使用できるかどうか検証します。
            lastmod要素は <acronym>W3C</acronym> 日付文字列を含まなければなりません。
            そして、任意で時間についての情報を無効にします。
        </para>

        <para>
            値が文字列で、プロトコルに従って妥当な場合に限り、
            <constant>TRUE</constant>を返します。
        </para>

        <example id="zend.validate.sitemap.lastmod.example">
            <title>サイトマップ Lastmod バリデータ</title>

            <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Sitemap_Lastmod();

$validator->isValid('1999-11-11T22:23:52-02:00'); // true
$validator->isValid('2008-05-12T00:42:52+02:00'); // true
$validator->isValid('1999-11-11'); // true
$validator->isValid('2008-05-12'); // true

$validator->isValid('1999-11-11t22:23:52-02:00'); // false
$validator->isValid('2008-05-12T00:42:60+02:00'); // false
$validator->isValid('1999-13-11'); // false
$validator->isValid('2008-05-32'); // false
$validator->isValid('yesterday'); // false
]]></programlisting>
        </example>
    </sect3>

    <sect3 id="zend.validate.sitemap.loc">
        <title>Sitemap_Loc</title>

        <para>
            文字列がサイトマップ <acronym>XML</acronym> 文書で 'loc' 要素として
            使用できるかどうか検証します。
            これは内部的に<methodname>Zend_Form::check()</methodname>を使います。
            詳しくは<link linkend="zend.uri.validation">URI の検証</link>を読んでください。
        </para>
    </sect3>

    <sect3 id="zend.validate.sitemap.priority">
        <title>Sitemap_Priority</title>

        <para>
            文字列がサイトマップ <acronym>XML</acronym> 文書で 'priority' 要素として
            使用できるかどうか検証します。
            値は、0.0と1.0の間の小数でなければなりません。
            このバリデータは、数値と文字列値の両方を受け入れます。
        </para>

        <example id="zend.validate.sitemap.priority.example">
            <title>サイトマップ 優先度 バリデータ</title>

            <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Sitemap_Priority();

$validator->isValid('0.1'); // true
$validator->isValid('0.789'); // true
$validator->isValid(0.8); // true
$validator->isValid(1.0); // true

$validator->isValid('1.1'); // false
$validator->isValid('-0.4'); // false
$validator->isValid(1.00001); // false
$validator->isValid(0xFF); // false
$validator->isValid('foo'); // false
]]></programlisting>
        </example>
    </sect3>

    <sect3 id="zend.validate.set.sitemap.options">
        <title>Zend_Validate_Sitemap_* でサポートされるオプション</title>

        <para>
            サイトマップ・バリデータのいずれもサポートするオプションはありません。
        </para>
    </sect3>
</sect2>