1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
<?php
/**
* @see https://github.com/zendframework/zend-server for the canonical source repository
* @copyright Copyright (c) 2005-2018 Zend Technologies USA Inc. (https://www.zend.com)
* @license https://github.com/zendframework/zend-server/blob/master/LICENSE.md New BSD License
*/
namespace Zend\Server;
use Zend\Server\Reflection\ReflectionClass;
use Zend\Server\Reflection\ReflectionFunction;
/**
* Reflection for determining method signatures to use with server classes
*/
class Reflection
{
/**
* Perform class reflection to create dispatch signatures
*
* Creates a {@link \Zend\Server\Reflection\ClassReflection} object for the class or
* object provided.
*
* If extra arguments should be passed to dispatchable methods, these may
* be provided as an array to $argv.
*
* @param string|object $class Class name or object
* @param bool|array $argv Optional arguments to be used during the method call
* @param string $namespace Optional namespace with which to prefix the
* method name (used for the signature key). Primarily to avoid collisions,
* also for XmlRpc namespacing
* @return \Zend\Server\Reflection\ReflectionClass
* @throws \Zend\Server\Reflection\Exception\InvalidArgumentException
*/
public static function reflectClass($class, $argv = false, $namespace = '')
{
if (is_object($class)) {
$reflection = new \ReflectionObject($class);
} elseif (is_string($class) && class_exists($class)) {
$reflection = new \ReflectionClass($class);
} else {
throw new Reflection\Exception\InvalidArgumentException('Invalid class or object passed to attachClass()');
}
if ($argv && ! is_array($argv)) {
throw new Reflection\Exception\InvalidArgumentException('Invalid argv argument passed to reflectClass');
}
return new ReflectionClass($reflection, $namespace, $argv);
}
/**
* Perform function reflection to create dispatch signatures
*
* Creates dispatch prototypes for a function. It returns a
* {@link Zend\Server\Reflection\FunctionReflection} object.
*
* If extra arguments should be passed to the dispatchable function, these
* may be provided as an array to $argv.
*
* @param string $function Function name
* @param bool|array $argv Optional arguments to be used during the method call
* @param string $namespace Optional namespace with which to prefix the
* function name (used for the signature key). Primarily to avoid
* collisions, also for XmlRpc namespacing
* @return \Zend\Server\Reflection\ReflectionFunction
* @throws \Zend\Server\Reflection\Exception\InvalidArgumentException
*/
public static function reflectFunction($function, $argv = false, $namespace = '')
{
if (! is_string($function) || ! function_exists($function)) {
throw new Reflection\Exception\InvalidArgumentException(sprintf(
'Invalid function "%s" passed to reflectFunction',
$function
));
}
if ($argv && ! is_array($argv)) {
throw new Reflection\Exception\InvalidArgumentException('Invalid argv argument passed to reflectFunction');
}
return new ReflectionFunction(new \ReflectionFunction($function), $namespace, $argv);
}
}