gpt4 book ai didi

php - PHPDoc 中的闭包语法

转载 作者:IT王子 更新时间:2023-10-29 00:12:48 24 4
gpt4 key购买 nike

我在 PHPDoc 中找不到任何关于闭包类型的文档。所以我的问题是如何定义发送到闭包的参数的参数及其返回值?

例子:

我如何描述“回调”将获得一个“MyCustomClass”、一个数字和一个字符串,并返回一个“MyOtherCustomClass”?

/**
* @param MyCustomClass $cls
* @param Closure $callback this isn't really explaining what this is
*
* @return MyOtherCustomClass
*/
function changer($cls, $callback){

return $callback($cls, 2, "a string");
}

changer($aCustomeClass, function($cls, $int, $string){
return new MyOtherCustomClass($cls, $int, $string);
})

或者如果可能的话?

最佳答案

@param callable $callback 确实是用于该部分的语法。您没有将该参数限制为闭包本身……传递给它的任何可调用对象都将在该实现中被接受。 Callable 是合法的“PHP 类型”,因此 phpDocumentor 接受它作为有效类型。

在您的示例代码中,实际上没有有理由假定您的changer() 方法返回MyOtherCustomClass(),因为那完全取决于您稍后在 changer() 用法中如何编写闭包。充其量,您可以在 changer() 用法中指出 changer() 的这种特殊用法 em> 返回 MyOtherCustomClass,因为返回特定类型对象的是该用法的实现,而不是 changer() 实现本身。

至于记录传递的可调用对象“需要”接受的参数,我想您必须在 param 标记的描述部分中这样做。没有语法来描述这种情况。

如果我要以这种方式实现某些东西,我会强加一个接口(interface),所有可调用对象都必须显式返回该接口(interface),因此我可以编写 changer() 返回该接口(interface)。当然,这意味着您的 MyOtherCustomClass 必须实现该接口(interface),但在我看来,这仍然是接近“强制”从 changer()< 返回类型的唯一方法.

关于php - PHPDoc 中的闭包语法,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/16589902/

24 4 0
Copyright 2021 - 2024 cfsdn All Rights Reserved 蜀ICP备2022000587号
广告合作:1813099741@qq.com 6ren.com