Merge branch 'master' of git://github.com/zendframework/zf2

src/AbstractFilter.php

@@ -20,6 +20,9 @@
 
 namespace Zend\Filter;
 
+use Traversable;
+use Zend\Stdlib\ArrayUtils;
+
 /**
  * @category   Zend
  * @package    Zend_Filter
@@ -28,6 +31,76 @@
  */
 abstract class AbstractFilter implements FilterInterface
 {
+    /**
+     * Filter options
+     *
+     * @var array
+     */
+    protected $options = array();
+
+    /**
+     * Is PCRE is compiled with UTF-8 and Unicode support
+     *
+     * @var boolean
+     **/
+    protected static $hasPcreUnicodeSupport = null;
+
+    /**
+     * @return bool
+     */
+    public static function hasPcreUnicodeSupport()
+    {
+        if (static::$hasPcreUnicodeSupport === null) {
+            if (defined('PREG_BAD_UTF8_OFFSET_ERROR') || @preg_match('/\pL/u', 'a') == 1){
+                static::$hasPcreUnicodeSupport = true;
+            } else {
+                static::$hasPcreUnicodeSupport = false;
+            }
+        }
+        return static::$hasPcreUnicodeSupport;
+    }
+
+    /**
+     * @param  array|Traversable $options
+     * @return AbstractFilter
+     * @throws Exception\InvalidArgumentException
+     */
+    public function setOptions($options)
+    {
+        if (!is_array($options) && !$options instanceof Traversable) {
+            throw new Exception\InvalidArgumentException(sprintf(
+                '"%s" expects an array or Traversable; received "%s"',
+                __METHOD__,
+                (is_object($options) ? get_class($options) : gettype($options))
+            ));
+        }
+
+        foreach ($options as $key => $value) {
+            $setter = 'set' . str_replace(' ', '', ucwords(str_replace('_', ' ', $key)));
+            if (method_exists($this, $setter)) {
+                $this->{$setter}($value);
+            } elseif (array_key_exists($key, $this->options)) {
+                $this->options[$key] = $value;
+            } else {
+                throw new Exception\InvalidArgumentException(sprintf(
+                    'The option "%s" does not have a matching %s setter method or options[%s] array key',
+                    $key, $setter, $key
+                ));
+            }
+        }
+        return $this;
+    }
+
+    /**
+     * Retrieve options representing object state
+     *
+     * @return array
+     */
+    public function getOptions()
+    {
+        return $this->options;
+    }
+
     /**
      * Invoke filter as a command
      *
@@ -41,4 +114,14 @@ public function __invoke($value)
     {
         return $this->filter($value);
     }
+
+    /**
+     *
+     * @param  mixed $options
+     * @return bool
+     */
+    protected static function isOptions($options)
+    {
+        return (is_array($options) || $options instanceof Traversable);
+    }
 }

src/AbstractUnicode.php

@@ -0,0 +1,76 @@
+<?php
+/**
+ * Zend Framework
+ *
+ * LICENSE
+ *
+ * This source file is subject to the new BSD license that is bundled
+ * with this package in the file LICENSE.txt.
+ * It is also available through the world-wide-web at this URL:
+ * http://framework.zend.com/license/new-bsd
+ * If you did not receive a copy of the license and are unable to
+ * obtain it through the world-wide-web, please send an email
+ * to [email protected] so we can send you a copy immediately.
+ *
+ * @category   Zend
+ * @package    Zend_Filter
+ * @copyright  Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license    http://framework.zend.com/license/new-bsd     New BSD License
+ */
+
+namespace Zend\Filter;
+
+/**
+ * @category   Zend
+ * @package    Zend_Filter
+ * @copyright  Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license    http://framework.zend.com/license/new-bsd     New BSD License
+ */
+abstract class AbstractUnicode extends AbstractFilter
+{
+    /**
+     * Set the input encoding for the given string
+     *
+     * @param  string|null $encoding
+     * @return StringToLower
+     * @throws Exception\InvalidArgumentException
+     * @throws Exception\ExtensionNotLoadedException
+     */
+    public function setEncoding($encoding = null)
+    {
+        if ($encoding !== null) {
+            if (!function_exists('mb_strtolower')) {
+                throw new Exception\ExtensionNotLoadedException(sprintf(
+                    '%s requires mbstring extension to be loaded',
+                    get_class($this)
+                ));
+            }
+
+            $encoding    = strtolower($encoding);
+            $mbEncodings = array_map('strtolower', mb_list_encodings());
+            if (!in_array($encoding, $mbEncodings)) {
+                throw new Exception\InvalidArgumentException(sprintf(
+                    "Encoding '%s' is not supported by mbstring extension",
+                    $encoding
+                ));
+            }
+        }
+
+        $this->options['encoding'] = $encoding;
+        return $this;
+    }
+
+    /**
+     * Returns the set encoding
+     *
+     * @return string
+     */
+    public function getEncoding()
+    {
+        if ($this->options['encoding'] === null && function_exists('mb_internal_encoding')) {
+            $this->options['encoding'] = mb_internal_encoding();
+        }
+
+        return $this->options['encoding'];
+    }
+}