Chris@0: <?php
Chris@0: /**
Chris@0:  * Zend Framework (http://framework.zend.com/)
Chris@0:  *
Chris@0:  * @link      http://github.com/zendframework/zf2 for the canonical source repository
Chris@0:  * @copyright Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
Chris@0:  * @license   http://framework.zend.com/license/new-bsd New BSD License
Chris@0:  */
Chris@0: 
Chris@0: namespace Zend\Stdlib;
Chris@0: 
Chris@0: use ArrayObject as PhpArrayObject;
Chris@0: 
Chris@0: class Parameters extends PhpArrayObject implements ParametersInterface
Chris@0: {
Chris@0:     /**
Chris@0:      * Constructor
Chris@0:      *
Chris@0:      * Enforces that we have an array, and enforces parameter access to array
Chris@0:      * elements.
Chris@0:      *
Chris@0:      * @param  array $values
Chris@0:      */
Chris@0:     public function __construct(array $values = null)
Chris@0:     {
Chris@0:         if (null === $values) {
Chris@0:             $values = [];
Chris@0:         }
Chris@0:         parent::__construct($values, ArrayObject::ARRAY_AS_PROPS);
Chris@0:     }
Chris@0: 
Chris@0:     /**
Chris@0:      * Populate from native PHP array
Chris@0:      *
Chris@0:      * @param  array $values
Chris@0:      * @return void
Chris@0:      */
Chris@0:     public function fromArray(array $values)
Chris@0:     {
Chris@0:         $this->exchangeArray($values);
Chris@0:     }
Chris@0: 
Chris@0:     /**
Chris@0:      * Populate from query string
Chris@0:      *
Chris@0:      * @param  string $string
Chris@0:      * @return void
Chris@0:      */
Chris@0:     public function fromString($string)
Chris@0:     {
Chris@0:         $array = [];
Chris@0:         parse_str($string, $array);
Chris@0:         $this->fromArray($array);
Chris@0:     }
Chris@0: 
Chris@0:     /**
Chris@0:      * Serialize to native PHP array
Chris@0:      *
Chris@0:      * @return array
Chris@0:      */
Chris@0:     public function toArray()
Chris@0:     {
Chris@0:         return $this->getArrayCopy();
Chris@0:     }
Chris@0: 
Chris@0:     /**
Chris@0:      * Serialize to query string
Chris@0:      *
Chris@0:      * @return string
Chris@0:      */
Chris@0:     public function toString()
Chris@0:     {
Chris@12:         return http_build_query($this->toArray());
Chris@0:     }
Chris@0: 
Chris@0:     /**
Chris@0:      * Retrieve by key
Chris@0:      *
Chris@0:      * Returns null if the key does not exist.
Chris@0:      *
Chris@0:      * @param  string $name
Chris@0:      * @return mixed
Chris@0:      */
Chris@0:     public function offsetGet($name)
Chris@0:     {
Chris@0:         if ($this->offsetExists($name)) {
Chris@0:             return parent::offsetGet($name);
Chris@0:         }
Chris@0:         return;
Chris@0:     }
Chris@0: 
Chris@0:     /**
Chris@0:      * @param string $name
Chris@0:      * @param mixed $default optional default value
Chris@0:      * @return mixed
Chris@0:      */
Chris@0:     public function get($name, $default = null)
Chris@0:     {
Chris@0:         if ($this->offsetExists($name)) {
Chris@0:             return parent::offsetGet($name);
Chris@0:         }
Chris@0:         return $default;
Chris@0:     }
Chris@0: 
Chris@0:     /**
Chris@0:      * @param string $name
Chris@0:      * @param mixed $value
Chris@0:      * @return Parameters
Chris@0:      */
Chris@0:     public function set($name, $value)
Chris@0:     {
Chris@0:         $this[$name] = $value;
Chris@0:         return $this;
Chris@0:     }
Chris@0: }