1
|
|
|
<?php |
2
|
|
|
/* |
3
|
|
|
* This file is part of the Respect\Rest package. |
4
|
|
|
* |
5
|
|
|
* For the full copyright and license information, please view the LICENSE |
6
|
|
|
* file that was distributed with this source code. |
7
|
|
|
*/ |
8
|
|
|
|
9
|
|
|
namespace Respect\Rest\Routines; |
10
|
|
|
|
11
|
|
|
use UnexpectedValueException; |
12
|
|
|
use ArrayObject; |
13
|
|
|
|
14
|
|
|
/** |
15
|
|
|
* Facilitates the keyed callback lists for routines. |
16
|
|
|
* @author Nick Lombard <[email protected]> |
17
|
|
|
*/ |
18
|
|
|
class AbstractCallbackList extends ArrayObject implements Routinable |
19
|
|
|
{ |
20
|
|
|
/** filters out non callable from the list, step copy to new storage */ |
21
|
40 |
|
public function __construct(array $list = array()) |
22
|
|
|
{ |
23
|
40 |
|
$this->setFlags(self::ARRAY_AS_PROPS); |
24
|
|
|
|
25
|
40 |
|
if (!($callbackList = array_filter($list, 'is_callable'))) { |
26
|
|
|
$message = 'Invalid setting: Not a single callable argument for callback routines: '.get_class($this); |
27
|
|
|
throw new UnexpectedValueException($message); |
28
|
|
|
} |
29
|
|
|
|
30
|
40 |
|
foreach ($callbackList as $acceptSpec => $callback) { |
31
|
40 |
|
if (true === is_callable($callback)) { |
32
|
40 |
|
$this[$acceptSpec] = $callback; |
33
|
|
|
} else { |
34
|
|
|
error_log("The $acceptSpec enry does not have a valid callback configured, it has been ignored.\n", 1); |
35
|
|
|
} |
36
|
|
|
} |
37
|
40 |
|
} |
38
|
|
|
|
39
|
|
|
/** |
40
|
|
|
* Public accessor methods, free for all (idempotent) |
41
|
|
|
* |
42
|
|
|
* @method getKeys to retrieve only the keys for conneg etc. |
43
|
|
|
* @method hasKey check if key is present |
44
|
|
|
* @method filterKeysContain fetch keys matching supplied string |
45
|
|
|
* @method filterKeysNotContain fetch keys that don't include string |
46
|
|
|
*/ |
47
|
34 |
|
public function getKeys() |
48
|
|
|
{ |
49
|
34 |
|
return array_keys($this->getArrayCopy()); |
50
|
|
|
} |
51
|
1 |
|
public function hasKey($key) |
52
|
|
|
{ |
53
|
1 |
|
return isset($this->$key); |
54
|
|
|
|
55
|
|
|
return array_key_exists($key, $this); |
|
|
|
|
56
|
|
|
} |
57
|
24 |
|
public function filterKeysContain($needle) |
58
|
|
|
{ |
59
|
|
|
return array_filter($this->getKeys(), function ($key) use ($needle) { |
60
|
24 |
|
return false !== strpos($key, $needle); |
61
|
24 |
|
}); |
62
|
|
|
} |
63
|
|
|
public function filterKeysNotContain($needle) |
64
|
|
|
{ |
65
|
1 |
|
return array_filter($this->getKeys(), function ($key) use ($needle) { |
66
|
1 |
|
return false === strpos($key, $needle); |
67
|
1 |
|
}); |
68
|
|
|
} |
69
|
|
|
|
70
|
|
|
/** |
71
|
|
|
* Protected accessor methods, members only. |
72
|
|
|
* |
73
|
|
|
* @method getCallback return the configured callback associated with key |
74
|
|
|
* @method executeCallback and forward supplied parmaters |
75
|
|
|
*/ |
76
|
30 |
|
protected function getCallback($key) |
77
|
|
|
{ |
78
|
30 |
|
return $this->$key; |
79
|
|
|
} |
80
|
|
|
|
81
|
1 |
|
protected function executeCallback($key, $params) |
82
|
|
|
{ |
83
|
1 |
|
return call_user_func_array($this->$key, $params); |
84
|
|
|
} |
85
|
|
|
} |
86
|
|
|
|
This check looks for unreachable code. It uses sophisticated control flow analysis techniques to find statements which will never be executed.
Unreachable code is most often the result of
return
,die
orexit
statements that have been added for debug purposes.In the above example, the last
return false
will never be executed, because a return statement has already been met in every possible execution path.