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 }
|