是否可以为参数指定多个类型提示?

时间:2010-10-01 14:26:42

标签: php type-hinting

有没有办法为方法添加多种类型提示?例如,foo(param)必须接收字符串OR bar OR baz。

的实例

5 个答案:

答案 0 :(得分:26)

这是不可能强制执行的(除了方法内部)。您只能提供单一类型提示,并且只能提供对象/接口和数组(自PHP 5.1起)。

您可以/应该在您的方法中记录它,即:

/**
 * @param string|Bar|Baz $param1
 */
function foo($param1);

答案 1 :(得分:16)

这是interfaces的一种用法。如果您想确保该对象具有->foobar($baz)方法,您可以期待一个接口:

interface iFooBar {
    public function foobar($baz);
}

class Foo implements iFooBar {
    public function foobar($baz) { echo $baz; }
}
class Bar implements iFooBar {
    public function foobar($baz) { print_r($baz); }
}

function doSomething(iFooBar $foo) {
    $foo->foobar('something');
}

然后,在呼叫时,这些将起作用:

doSomething(new Foo());
doSomething(new Bar());

这些不会:

doSomething(new StdClass());
doSomething('testing');

答案 2 :(得分:11)

在撰写本文时,不支持多种显式类型。您必须依赖文档和PHP的动态类型系统。

但是,对于union types,我的提案大多不完整。它的目标是7.NEXT(在撰写本文时为7.1)或8(以先到者为准)。

以下是我认为非常有价值的一个简单例子:array | Traversable

function map(callable $fn, array|Traversable $input) {
    foreach ($input as $key => $value) {
        yield $key => $fn($value);
    }
}

不幸的是,RFC没有通过;但是对于特定类型array|Traversable,现在有一个iterable类型,正是如此。

答案 3 :(得分:6)

Type hinting只允许每个参数提示一次(同时,提示需要为array或类名,你不能提示string),但你可以做通过使用get_class

检查函数中param的类型
function foo($param)
{
  if (!(is_string($param) || in_array(get_class($param), array("Bar", "Baz")))
  {
    // invalid type for $param!
  }
}

如果你愿意的话,你甚至可以使用trigger_error让它失败并出现PHP错误(就像类型提示失败时一样)。

答案 4 :(得分:5)

很棒的问题。它适用于IDE文档和PHP 5 Type Hinting。 你必须记住,在OO中polymorphism是你的朋友。

如果您创建基类并扩展它们,您的类型提示将是基类...所有扩展类都将起作用。见下面的例子。

//
$test = new DUITest();

//  Calls below will work because of polymorphism
echo $test->test(new Molecule()) . '<br/>';
echo $test->test(new Vodka()) . '<br/>';
echo $test->test(new Driver()) . '<br/>';
echo $test->test(new Car()) . '<br/>';

//  Will not work because different data type
echo $test->test(new Pig()) . '<br/>';
echo $test->test(new Cop()) . '<br/>';
echo $test->test('test') . '<br/>';
echo $test->test(array()) . '<br/>';



/**
 * Class to test 
 */
class DUITest {

    public function __construct() {
        ;
    }

    /**
     * Using type-hinting
     * 
     * See below link for more information
     * @link http://www.php.net/manual/en/language.oop5.typehinting.php
     * 
     * @param Molecule|Car|Driver|Vodka $obj 
     */
    public function test(Molecule $obj) {
        echo $obj;
    }

}

/**
 * Base Class
 */
class Molecule {

    public function __construct() {}

    /**
     * Outputs name of class of current object
     * @return <type> 
     */
    public function __toString() {
        return get_class($this);
    }

}

class Car extends Molecule {}

class Driver extends Molecule {}

class Vodka extends Molecule {}

class Pig {}
class Cop extends Pig{}