Zend_Uri は、 Uniform Resource Identifiers (URIs) の操作および検証を行うためのコンポーネントです。 Zend_Uri の本来の目的は Zend_Http_Client のような他のコンポーネントを支援することですが、 単体で使用しても便利です。

URI の最初は常にスキームから始まり、その後にコロンが続きます。 スキームにはさまざまなものがあります。 Zend_Uri クラスは、 各スキームに特化した自身のサブクラスを返すファクトリメソッドを提供しています。 サブクラスの名前は Zend_Uri_<scheme> となり、<scheme> の部分には スキーム名の最初の文字だけを大文字にしたものがあてはまります。 この規則にはひとつ例外があり、HTTPS スキームについては Zend_Uri_Http で扱われます。

スキームのみを Zend_Uri::factory() に渡すと、 Zend_Uri は新しい URI をゼロから作成します。

// 何もないところから新しい URI を作成するには、スキームのみを渡します
$uri = Zend_Uri::factory('http');

// $uri は Zend_Uri_Http のインスタンスとなります

      

新しい URI を作成するには、スキームのみを Zend_Uri::factory() に渡します ^[24]。 サポートしていないスキームが渡された場合は、 Zend_Uri_Exception がスローされます。

渡されたスキームあるいは URI をサポートしている場合は、 Zend_Uri::factory() は自分自身のサブクラスを返します。 これは、指定したスキームに特化したものとなります。

既存の URI を操作するには、完全な URI を Zend_Uri::factory() に渡します。

// 既存の URI を操作するには、それを渡します
$uri = Zend_Uri::factory('http://www.zend.com');

// $uri は Zend_Uri_Http のインスタンスです

      

このとき、URI のパースと検証が行われます。 もし妥当な形式でなかった場合は、そこで Zend_Uri_Exception がスローされます。それ以外の場合は Zend_Uri::factory() は自分自身のサブクラスを返します。 これは、操作するスキームに特化したものとなります。

Zend_Uri::check() 関数を使用すると、 既存の URI の検証のみを行うことができます。

// 指定した URI が正しい形式かどうかを調べます
$valid = Zend_Uri::check('http://uri.in.question');

// $valid は、正しければ TRUE、そうでなければ FALSE となります

      

Zend_Uri::check() は boolean 値を返します。 これは Zend_Uri::factory() を使用して例外を処理するよりも便利です。

50.1.4.1. URL 内での "Unwise" 文字の許可

デフォルトでは、Zend_Uri は次の文字を許可しません。 "{", "}", "|", "\", "^", "`" これらは RFC で "unwise" と定義されており無効なものです。 しかし、多くの実装ではこれらの文字を妥当なものとして扱います。

Zend_Uri でもこれらの "unwise" 文字を許可することができます。 そのためには、Zend_Uri::setConfig() メソッドで 'allow_unwise' オプションを TRUE に設定します。

例 50.4. URI における特殊文字の許可

// 通常は、これは false を返します
$valid = Zend_Uri::check('http://example.com/?q=this|that'); // '|' を含んでいます

// しかし、"unwise" 文字を許可することもできます
Zend_Uri::setConfig(array('allow_unwise' => true));
$valid = Zend_Uri::check('http://example.com/?q=this|that'); // これは 'true' を返します

// 'allow_unwise' の値をデフォルトの FALSE に戻します
Zend_Uri::setConfig(array('allow_unwise' => false));

            

	注意
	Zend_Uri::setConfig() は、全体の設定オプションを変更します。 そのため、上の例のように最後は 'allow_unwise' を 'false' に戻すことを推奨します。unwise な文字を常に許可したいという場合は別です。

すべての Zend_Uri のサブクラス (例 Zend_Uri_Http) のインスタンスには、 URI 操作のために便利なインスタンスメソッドがいくつか提供されています。

$uri = Zend_Uri::factory('http://www.zend.com');

$scheme = $uri->getScheme();  // "http"

        

$uri = Zend_Uri::factory('http://www.zend.com');

echo $uri->getUri();  // "http://www.zend.com"

        

$uri = Zend_Uri::factory('http://www.zend.com');

$isValid = $uri->valid();  // TRUE