Zend_Uri(日本語)概要Zend_Uri は、 » Uniform Resource Identifiers (URIs) の操作および検証を行うためのコンポーネントです。 Zend_Uri の本来の目的は Zend_Http_Client のような他のコンポーネントを支援することですが、 単体で使用しても便利です。 URI の最初は常にスキームから始まり、その後にコロンが続きます。 スキームにはさまざまなものがあります。 Zend_Uri クラスは、 各スキームに特化した自身のサブクラスを返すファクトリメソッドを提供しています。 サブクラスの名前は Zend_Uri_<scheme> となり、<scheme> の部分には スキーム名の最初の文字だけを大文字にしたものがあてはまります。 この規則にはひとつ例外があり、HTTPS スキームについては Zend_Uri_Http で扱われます。 新しい URI の作成スキームのみを Zend_Uri::factory() に渡すと、 Zend_Uri は新しい URI をゼロから作成します。 Example #1 Zend_Uri::factory() による新しい URI の作成
新しい URI を作成するには、スキームのみを Zend_Uri::factory() に渡します [1]HTTPHTTPSZend_Uri。 サポートしていないスキームが渡された場合は、 Zend_Uri_Exception がスローされます。 渡されたスキームあるいは URI をサポートしている場合は、 Zend_Uri::factory() は自分自身のサブクラスを返します。 これは、指定したスキームに特化したものとなります。 Creating a New Custom-Class URIStarting from Zend Framework 1.10.5, you can specify a custom class to be used when creating the Zend_Uri instance, as a second parameter to the Zend_Uri::factory() method. This enables you to subclass Zend_Uri and create your own custom URI classes, and instantiate new URI objects based on your own custom classes. The 2nd parameter passed to Zend_Uri::factory() must be a string with the name of a class extending Zend_Uri. The class must either be alredy-loaded, or loadable using Zend_Loader::loadClass() - that is, it must follow the Zend Framework class and file naming conventions, and must be in your include_path. Example #2 Creating a URI using a custom class
既存の URI の操作既存の URI を操作するには、完全な URI を Zend_Uri::factory() に渡します。 Example #3 Zend_Uri::factory() による既存の URI の操作
このとき、URI のパースと検証が行われます。 もし妥当な形式でなかった場合は、そこで Zend_Uri_Exception がスローされます。それ以外の場合は Zend_Uri::factory() は自分自身のサブクラスを返します。 これは、操作するスキームに特化したものとなります。 URI の検証Zend_Uri::check() 関数を使用すると、 既存の URI の検証のみを行うことができます。 Example #4 Zend_Uri::check() による URI の検証
Zend_Uri::check() は boolean 値を返します。 これは Zend_Uri::factory() を使用して例外を処理するよりも便利です。 URL 内での "Unwise" 文字の許可デフォルトでは、Zend_Uri は次の文字を許可しません。 "{", "}", "|", "\", "^", "`" これらは RFC で "unwise" と定義されており無効なものです。 しかし、多くの実装ではこれらの文字を妥当なものとして扱います。 Zend_Uri でもこれらの "unwise" 文字を許可することができます。 そのためには、 Zend_Uri::setConfig() メソッドで 'allow_unwise' オプションを TRUE に設定します。 Example #5 URI における特殊文字の許可
共通のインスタンスメソッドすべての Zend_Uri のサブクラス (例 Zend_Uri_Http) のインスタンスには、 URI 操作のために便利なインスタンスメソッドがいくつか提供されています。 URI のスキームの取得URI のスキームとは、URI でカンマの前にくる部分のことです。 たとえば http://www.zend.com のスキームは "http" となります。 Example #6 Zend_Uri_* オブジェクトからのスキームの取得
インスタンスメソッド getScheme() は、 URI オブジェクトからスキームの部分のみを返します。 URI 全体の取得Example #7 Zend_Uri_* オブジェクトからの URI 全体の取得
getUri() メソッドは、URI 全体を文字列として返します。 URI の検証Zend_Uri::factory() は渡された URI を常に検証しており、 渡された URI が無効な場合は Zend_Uri のサブクラスのインスタンスを作成しません。しかし、いったん Zend_Uri のサブクラスのインスタンスを (新規に、あるいは既存のものから) 作成し、 それを操作した後でもまだ妥当な形式であるかどうかを調べることもできます。 Example #8 Zend_Uri_* オブジェクトの検証
インスタンスメソッド valid() により、 URI オブジェクトが妥当なものかどうかを調べることができます。 [1]
現時点では、
および に対する組み込みサポートだけを
では提供しています。
|