Zend Framework フィルター Zend_Filter の使用法の詳細な説明

この記事の例では、Zend Framework フィルター Zend_Filter の使用法について説明します。参考のために皆さんと共有してください。詳細は次のとおりです:

はじめに: フィルターは、入力コンテンツをフィルターし、フィルター ルールを満たさないコンテンツを削除し、残りのコンテンツを返すプロセスです。

Zend にはフィルタリング機能を実装するための Zend_Filter コンポーネントがあります。 Zend_Filter_Interface サブクラスがあり、一般的なフィルターを実装するためのインターフェイスを提供します。

フィルター クラスを実装するには、このインターフェイスに filter() という名前のメソッドを実装する必要があります。

以下は、Zend_Filter で定義されたフィルターの使用方法を示す例です。この例では、文字を小文字に変換する関数を実装する方法を示します。

コード:

<?php
require_once &#39;Zend/Filter/StringToLower.php&#39;;  //加载子类
$filter = new Zend_Filter_StringToLower;    //实例化对象
$temp1 = "ABCDefGH";              //定义待过滤内容
$temp2 = "我爱Nan Jing";
echo "内容：".$temp1."<p>经过滤后为：";
echo $filter->filter($temp1);
echo "<p>";
echo "内容：".$temp2."<p>经过滤后为：";
echo $filter->filter($temp2);

結果:

内容: ABCDefGH
フィルタリング後: abcdefgh
内容: 私は南京が大好きです
フィルタリング後: 私は南京が大好きです

なぜそんなに魔法なのですか?内部構造を調べてみたくなりますね！その内部動作原理を調べてみましょう。

class Zend_Filter_StringToLower implements Zend_Filter_Interface
{
  /**
   * Encoding for the input string
   *
   * @var string
   */
  protected $_encoding = null;
  /**
   * Constructor
   *
   * @param string|array|Zend_Config $options OPTIONAL
   */
  public function __construct($options = null)
  {
    if ($options instanceof Zend_Config) {
      $options = $options->toArray();
    } else if (!is_array($options)) {
      $options = func_get_args();
      $temp  = array();
      if (!empty($options)) {
        $temp['encoding'] = array_shift($options);
      }
      $options = $temp;
    }
    if (!array_key_exists('encoding', $options) && function_exists('mb_internal_encoding')) {
      $options['encoding'] = mb_internal_encoding();
    }
    if (array_key_exists('encoding', $options)) {
      $this->setEncoding($options['encoding']);
    }
  }
  /**
   * Returns the set encoding
   *
   * @return string
   */
  public function getEncoding()
  {
    return $this->_encoding;
  }
  /**
   * Set the input encoding for the given string
   *
   * @param string $encoding
   * @return Zend_Filter_StringToLower Provides a fluent interface
   * @throws Zend_Filter_Exception
   */
  public function setEncoding($encoding = null)
  {
    if ($encoding !== null) {
      if (!function_exists('mb_strtolower')) {
        require_once 'Zend/Filter/Exception.php';
        throw new Zend_Filter_Exception('mbstring is required for this feature');
      }
      $encoding = (string) $encoding;
      if (!in_array(strtolower($encoding), array_map('strtolower', mb_list_encodings()))) {
        require_once 'Zend/Filter/Exception.php';
        throw new Zend_Filter_Exception("The given encoding '$encoding' is not supported by mbstring");
      }
    }
    $this->_encoding = $encoding;
    return $this;
  }
  /**
   * Defined by Zend_Filter_Interface
   *
   * Returns the string $value, converting characters to lowercase as necessary
   *
   * @param string $value
   * @return string
   */
  public function filter($value)
  {
    if ($this->_encoding !== null) {
      return mb_strtolower((string) $value, $this->_encoding);
    }
    return strtolower((string) $value);
  }
}

勉強:

ソースコードの意味は、おそらく最初に Zend_Filter_Interface インターフェースを実装することです。

プライベート変数 $_encoding を定義します。通常、プライベート変数は _underscore で始まります。

次に、コンストラクターを通じて初期化作業を実行し、エンコーディングを設定します。

このエンコーディング属性の目的については、はっきりとは分かりませんが、ソースコードには多くのコードが書かれています。

クラスには 3 つのメソッドがあり、1 つは setEncoding、1 つは getEncoding、そしてメイン関数は filter です。エンコード用に記述されたメソッドが 2 つあります。

コンストラクターで setEncoding メソッドを使用するには、$this->setEncoding() を使用するだけです。次に、プライベート属性の値を設定できます。

次に、プライベート属性の内容に基づいて文字を小文字にするために使用する方法を選択します。

任せてください、このカテゴリには考慮すべきことが本当に十分にあります。実際、コア コードは strto lower((string) $value) という 2 つの文だけです。

このクラスはクールです。私はプライベート プロパティを使用したことがありません。考察されている問題は著者ほど包括的ではなく、さまざまな検証やさまざまな状況が考慮されています。たとえば、

コンストラクターが問題をどれほど包括的に検討しているかを見ることができます。

if ($options instanceof Zend_Config) {
  $options = $options->toArray();
} else if (!is_array($options)) {
  $options = func_get_args();
  $temp  = array();
  if (!empty($options)) {
    $temp['encoding'] = array_shift($options);
  }
  $options = $temp;
}
if (!array_key_exists('encoding', $options) && function_exists('mb_internal_encoding')) {
  $options['encoding'] = mb_internal_encoding();
}
if (array_key_exists('encoding', $options)) {
  $this->setEncoding($options['encoding']);
}

一般的に言って、それは賞賛に値します。

フィルターチェーンについて話しましょう。その機能は、複数のフィルターを直列に接続して一緒に使用することです。フィルター チェーンは複数のフィルターを接続したものです。指定されたコンテンツをフィルタリングする場合、

各フィルタはその順序で個別にフィルタリングまたは変換操作を実行します。すべてのフィルタリング操作が完了すると、フィルタ チェーンは最終的なフィルタリング結果を返します。

面白そうですね！

具体的な実装手順は何ですか?

まず、クラス Zend_Filter のオブジェクトをインスタンス化し、次にインスタンスの addFilter() メソッドを通じてフィルター チェーンにフィルターを追加します。

次の例は、フィルター チェーンを使用してデータの複数のフィルター処理と変換を実行する方法を示しています。

コード:

<?php
require_once &#39;Zend/Filter.php&#39;;         //加载Zend_Filter类
require_once &#39;Zend/Filter/Alpha.php&#39;;      //加载Zend_Filter_Alpha子类
require_once &#39;Zend/Filter/StringToUpper.php&#39;;  //加载Zend_Filter_StringToUpper子类
$filterChain = new Zend_Filter();        //创建过滤器链
$filterChain ->addFilter(new Zend_Filter_Alpha(" "))
  ->addFilter(new Zend_Filter_StringToUpper());//向过滤器链中添加过滤器
$temp1 = "12345asdf67asdfasdf";
$temp2 = "#$%^!@fffff";
$temp3 = "Welcome to Bei Jing";
echo "内容:".$temp1."<p>经过过滤后为：";
echo $filterChain->filter($temp1);
echo "<p>";
echo "内容:".$temp2."<p>经过过滤后为：";
echo $filterChain->filter($temp2);
echo "<p>";
echo "内容:".$temp3."<p>经过过滤后为：";
echo $filterChain->filter($temp3);
echo "<p>";

結果:

コンテンツ: 12345asdf67asdfasdf
フィルタリング後: ASDFASDFASDF
コンテンツ: Bei Jingへようこそ
フィルタリング後: WELCOME TO JING

分析:

ここでの Alpha は非常に強力で、数字や特殊文字、さらにはスペースもフィルタリングします。幸いなことに、初期化中にパラメータ「 」を追加したため、スペースは保持されました。

なぜそんなに魔法なのですか?

これがコアコードです

​​

public function filter($value)
{
    $whiteSpace = $this->allowWhiteSpace ? '\s' : '';
    if (!self::$_unicodeEnabled) {
      // POSIX named classes are not supported, use alternative a-zA-Z match
      $pattern = '/[^a-zA-Z' . $whiteSpace . ']/';
    } else if (self::$_meansEnglishAlphabet) {
      //The Alphabet means english alphabet.
      $pattern = '/[^a-zA-Z' . $whiteSpace . ']/u';
    } else {
      //The Alphabet means each language's alphabet.
      $pattern = '/[^\p{L}' . $whiteSpace . ']/u';
    }
    return preg_replace($pattern, '', (string) $value);
}

分析: コンテンツはここでフィルタリングされ、文字またはスペースでない場合はすべて削除されます。使用されるphpメソッドはpreg_replaceです。さらに、正規表現が使用されます。 [^a-zA-Z] はこれ以外の文字を表します。

ここでの $whiteSpace メンバー属性は初期化中に設定されます。具体的なコードは次のとおりです:

public function __construct($allowWhiteSpace = false)
{
    if ($allowWhiteSpace instanceof Zend_Config) {
      $allowWhiteSpace = $allowWhiteSpace->toArray();
    } else if (is_array($allowWhiteSpace)) {
      if (array_key_exists('allowwhitespace', $allowWhiteSpace)) {
        $allowWhiteSpace = $allowWhiteSpace['allowwhitespace'];
      } else {
        $allowWhiteSpace = false;
      }
    }
    $this->allowWhiteSpace = (boolean) $allowWhiteSpace;
    if (null === self::$_unicodeEnabled) {
      self::$_unicodeEnabled = (@preg_match('/\pL/u', 'a')) ? true : false;
    }
    if (null === self::$_meansEnglishAlphabet) {
      $this->_locale = new Zend_Locale('auto');
      self::$_meansEnglishAlphabet = in_array($this->_locale->getLanguage(),
      array('ja', 'ko', 'zh')
      );
    }
}

さらに、スペースを許可するかどうかを設定するメソッドと、スペースを許可するかどうかを取得するメソッドが 2 つあります。

/**
* Returns the allowWhiteSpace option
*
* @return boolean
*/
public function getAllowWhiteSpace()
{
    return $this->allowWhiteSpace;
}
/**
* Sets the allowWhiteSpace option
*
* @param boolean $allowWhiteSpace
* @return Zend_Filter_Alpha Provides a fluent interface
*/
public function setAllowWhiteSpace($allowWhiteSpace)
{
    $this->allowWhiteSpace = (boolean) $allowWhiteSpace;
    return $this;
}

それを分析した後、通常のフィルタリングを使用しているだけで、その構造がよりよく理解できるようです。同時に、allowWhiteSpace 属性を使用して、スペースをフィルタリングするかどうかを制御します。

先ほど 2 つのフィルターを紹介しました。1 つは StringToUpper、もう 1 つは Alpha です。以下に他のフィルターをいくつか紹介します。

1 つ目は、非数値および非文字コンテンツをフィルタリングする Alnum です。 filter() メソッドを実行すると、純粋な数値および文字コンテンツが返されます。これは、Zend_Filter_Alpha (非文字のフィルタリング) と Zend_Filter_Digits (非文字のフィルタリング) の結合です。数値）。

具体的な例は挙げませんが、どれも似たような例です。

その内部構造を見てみましょう。

public function filter($value)
{
    $whiteSpace = $this->allowWhiteSpace ? '\s' : '';
    if (!self::$_unicodeEnabled) {
      // POSIX named classes are not supported, use alternative a-zA-Z0-9 match
      $pattern = '/[^a-zA-Z0-9' . $whiteSpace . ']/';
    } else if (self::$_meansEnglishAlphabet) {
      //The Alphabet means english alphabet.
      $pattern = '/[^a-zA-Z0-9' . $whiteSpace . ']/u';
    } else {
      //The Alphabet means each language's alphabet.
      $pattern = '/[^\p{L}\p{N}' . $whiteSpace . ']/u';
    }
    return preg_replace($pattern, '', (string) $value);
}

正規表現を使用して文字と数字以外のコンテンツをフィルタリングします。

以下は HtmlEntities HTML フィルターです。

コード:

<?php
require_once &#39;Zend/Filter/Htmlentities.php&#39;;
$filter = new Zend_Filter_HtmlEntities();
$temp1 = "<img src = &#39;./1.png&#39; width=&#39;100px&#39;>";
$temp2 = "<button>aaa</button>";
$temp3 = "<h1>Welcome to Bei Jing</h1>";
echo "内容:".$temp1."<p>经过过滤为：";
echo $filter->filter($temp1);
echo "<p>";
echo "内容:".$temp2."<p>经过过滤为：";
echo $filter->filter($temp2);
echo "<p>";
echo "内容:".$temp3."<p>经过过滤为：";
echo $filter->filter($temp3);
echo "<p>";

結果:

結果から、HTML コンテンツを元のコードに復元していることがわかります。このフィルターは関数 htmlentities のカプセル化であるため、この関数の規則に従います。つまり、「e541b52b254dc5f8a220aae37694ce5c」はそれぞれ「e541b52b254dc5f8a220aae37694ce5c」に変換され、

の対応するHTMLコンテンツは元の形式で表示されます。

この記事が、Zend Framework フレームワークに基づいた PHP プログラミングの皆様のお役に立てれば幸いです。

Zend Framework フィルター Zend_Filter の使用法に関する詳細な説明については、PHP 中国語 Web サイトに注目してください。