寻找PHP7返回值类型声明的PHP5.6等效兼容写法

适配方案合法性确认 #

直接删除: bool/: void/: array这类返回类型声明后缀的操作是完全正确的，本身不会引发语法错误。

原因说明 #

返回值类型声明是PHP7.0版本才正式加入的新特性，PHP5.6及更低版本的解析器完全无法识别该语法规则，你遇到的syntax error, unexpected '}', expecting ',' or ';'报错就是解析器读到:符号后无法解析后续内容导致的，删除该部分后缀是适配PHP5.6环境的唯一语法兼容方案。

潜在风险说明 #

该操作不会改变原有函数的返回值内容，原有PHP7环境下函数的返回结果和PHP5.6删除声明后的返回结果完全一致，正常业务逻辑不会受影响。仅存在两处隐性风险：

• 原有PHP7环境下的返回类型校验逻辑会失效：如果函数返回了不符合原声明类型的值，PHP7会抛出TypeError错误提前拦截，PHP5.6下不会做该校验，隐性的类型错误可能会传递到后续业务逻辑中引发问题。
• : void声明对应的无返回值规则不再受语法约束：如果后续修改代码时给原本无返回值的函数增加了返回值，PHP5.6不会抛出报错，需要开发者自行保证逻辑一致性。

PHP5.6下等效替代写法 #

PHP5.6没有原生的返回类型声明语法，你可以通过PHPDoc注释的方式保留类型提示能力，该写法不会影响代码运行，同时可以给IDE提供代码补全、类型校验的依据，示例如下：

带返回值类型的函数示例 #

/**
 * 判断输入内容对应的路径是否为文件
 * @param mixed $data 待判断的路径参数
 * @return bool 存在且为文件返回true，否则返回false
 */
private function isFile($data)
{
    return file_exists($data);
}

void类型无返回值函数示例 #

/**
 * 处理XML元素闭合逻辑
 * @param Stream $stream 流对象实例
 * @return void 无返回值
 */
private function handleElementClose(Stream $stream)
{
    // Skip '</'
    $stream->next(2);
    $element = $stream->readTo('>');
    // Skip '>'
    $stream->next();
    $this->closeElement($stream, $element);
}

内容的提问来源于stack exchange，提问作者user3436467