annotate vendor/zendframework/zend-stdlib/src/AbstractOptions.php @ 19:fa3358dc1485 tip

Add ndrum files
author Chris Cannam
date Wed, 28 Aug 2019 13:14:47 +0100
parents 7a779792577d
children
rev   line source
Chris@0 1 <?php
Chris@0 2 /**
Chris@0 3 * Zend Framework (http://framework.zend.com/)
Chris@0 4 *
Chris@0 5 * @link http://github.com/zendframework/zf2 for the canonical source repository
Chris@0 6 * @copyright Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
Chris@0 7 * @license http://framework.zend.com/license/new-bsd New BSD License
Chris@0 8 */
Chris@0 9
Chris@0 10 namespace Zend\Stdlib;
Chris@0 11
Chris@0 12 use Traversable;
Chris@0 13
Chris@0 14 abstract class AbstractOptions implements ParameterObjectInterface
Chris@0 15 {
Chris@12 16 // @codingStandardsIgnoreStart
Chris@0 17 /**
Chris@0 18 * We use the __ prefix to avoid collisions with properties in
Chris@0 19 * user-implementations.
Chris@0 20 *
Chris@0 21 * @var bool
Chris@0 22 */
Chris@0 23 protected $__strictMode__ = true;
Chris@12 24 // @codingStandardsIgnoreEnd
Chris@0 25
Chris@0 26 /**
Chris@0 27 * Constructor
Chris@0 28 *
Chris@0 29 * @param array|Traversable|null $options
Chris@0 30 */
Chris@0 31 public function __construct($options = null)
Chris@0 32 {
Chris@0 33 if (null !== $options) {
Chris@0 34 $this->setFromArray($options);
Chris@0 35 }
Chris@0 36 }
Chris@0 37
Chris@0 38 /**
Chris@0 39 * Set one or more configuration properties
Chris@0 40 *
Chris@0 41 * @param array|Traversable|AbstractOptions $options
Chris@0 42 * @throws Exception\InvalidArgumentException
Chris@0 43 * @return AbstractOptions Provides fluent interface
Chris@0 44 */
Chris@0 45 public function setFromArray($options)
Chris@0 46 {
Chris@0 47 if ($options instanceof self) {
Chris@0 48 $options = $options->toArray();
Chris@0 49 }
Chris@0 50
Chris@12 51 if (! is_array($options) && ! $options instanceof Traversable) {
Chris@0 52 throw new Exception\InvalidArgumentException(
Chris@0 53 sprintf(
Chris@0 54 'Parameter provided to %s must be an %s, %s or %s',
Chris@0 55 __METHOD__,
Chris@0 56 'array',
Chris@0 57 'Traversable',
Chris@0 58 'Zend\Stdlib\AbstractOptions'
Chris@0 59 )
Chris@0 60 );
Chris@0 61 }
Chris@0 62
Chris@0 63 foreach ($options as $key => $value) {
Chris@0 64 $this->__set($key, $value);
Chris@0 65 }
Chris@0 66
Chris@0 67 return $this;
Chris@0 68 }
Chris@0 69
Chris@0 70 /**
Chris@0 71 * Cast to array
Chris@0 72 *
Chris@0 73 * @return array
Chris@0 74 */
Chris@0 75 public function toArray()
Chris@0 76 {
Chris@0 77 $array = [];
Chris@0 78 $transform = function ($letters) {
Chris@0 79 $letter = array_shift($letters);
Chris@0 80 return '_' . strtolower($letter);
Chris@0 81 };
Chris@0 82 foreach ($this as $key => $value) {
Chris@0 83 if ($key === '__strictMode__') {
Chris@0 84 continue;
Chris@0 85 }
Chris@0 86 $normalizedKey = preg_replace_callback('/([A-Z])/', $transform, $key);
Chris@0 87 $array[$normalizedKey] = $value;
Chris@0 88 }
Chris@0 89 return $array;
Chris@0 90 }
Chris@0 91
Chris@0 92 /**
Chris@0 93 * Set a configuration property
Chris@0 94 *
Chris@0 95 * @see ParameterObject::__set()
Chris@0 96 * @param string $key
Chris@0 97 * @param mixed $value
Chris@0 98 * @throws Exception\BadMethodCallException
Chris@0 99 * @return void
Chris@0 100 */
Chris@0 101 public function __set($key, $value)
Chris@0 102 {
Chris@0 103 $setter = 'set' . str_replace('_', '', $key);
Chris@0 104
Chris@0 105 if (is_callable([$this, $setter])) {
Chris@0 106 $this->{$setter}($value);
Chris@0 107
Chris@0 108 return;
Chris@0 109 }
Chris@0 110
Chris@0 111 if ($this->__strictMode__) {
Chris@0 112 throw new Exception\BadMethodCallException(sprintf(
Chris@0 113 'The option "%s" does not have a callable "%s" ("%s") setter method which must be defined',
Chris@0 114 $key,
Chris@0 115 'set' . str_replace(' ', '', ucwords(str_replace('_', ' ', $key))),
Chris@0 116 $setter
Chris@0 117 ));
Chris@0 118 }
Chris@0 119 }
Chris@0 120
Chris@0 121 /**
Chris@0 122 * Get a configuration property
Chris@0 123 *
Chris@0 124 * @see ParameterObject::__get()
Chris@0 125 * @param string $key
Chris@0 126 * @throws Exception\BadMethodCallException
Chris@0 127 * @return mixed
Chris@0 128 */
Chris@0 129 public function __get($key)
Chris@0 130 {
Chris@0 131 $getter = 'get' . str_replace('_', '', $key);
Chris@0 132
Chris@0 133 if (is_callable([$this, $getter])) {
Chris@0 134 return $this->{$getter}();
Chris@0 135 }
Chris@0 136
Chris@0 137 throw new Exception\BadMethodCallException(sprintf(
Chris@0 138 'The option "%s" does not have a callable "%s" getter method which must be defined',
Chris@0 139 $key,
Chris@0 140 'get' . str_replace(' ', '', ucwords(str_replace('_', ' ', $key)))
Chris@0 141 ));
Chris@0 142 }
Chris@0 143
Chris@0 144 /**
Chris@0 145 * Test if a configuration property is null
Chris@0 146 * @see ParameterObject::__isset()
Chris@0 147 * @param string $key
Chris@0 148 * @return bool
Chris@0 149 */
Chris@0 150 public function __isset($key)
Chris@0 151 {
Chris@0 152 $getter = 'get' . str_replace('_', '', $key);
Chris@0 153
Chris@0 154 return method_exists($this, $getter) && null !== $this->__get($key);
Chris@0 155 }
Chris@0 156
Chris@0 157 /**
Chris@0 158 * Set a configuration property to NULL
Chris@0 159 *
Chris@0 160 * @see ParameterObject::__unset()
Chris@0 161 * @param string $key
Chris@0 162 * @throws Exception\InvalidArgumentException
Chris@0 163 * @return void
Chris@0 164 */
Chris@0 165 public function __unset($key)
Chris@0 166 {
Chris@0 167 try {
Chris@0 168 $this->__set($key, null);
Chris@0 169 } catch (Exception\BadMethodCallException $e) {
Chris@0 170 throw new Exception\InvalidArgumentException(
Chris@0 171 'The class property $' . $key . ' cannot be unset as'
Chris@0 172 . ' NULL is an invalid value for it',
Chris@0 173 0,
Chris@0 174 $e
Chris@0 175 );
Chris@0 176 }
Chris@0 177 }
Chris@0 178 }