php 7.1 引入了 void 返回类型声明，它的核心作用只有一个：强制函数不能返回值。实际开发中，如果你写了一个纯粹执行副作用（比如写日志、更新数据库状态）的函数，使用 void 可以防止调用者误以为它能返回数据，从而避免潜在的逻辑错误。
基础用法与严格模式
在函数签名中使用 void 作为返回类型，意味着该函数必须不返回任何值。这包括不能使用 return $value;，甚至不能使用空的 return; 语句。如果函数体内意外包含了返回语句，PHP 会在运行时抛出 TypeError。
以下是一个标准的示例：
<?php
function logAction(string $action): void {
echo "Executing: {$action}" . PHP_EOL;
// 这里不能有 return 语句
}
logAction('user_login');预期输出为：
Executing: user_login
如果你在函数末尾加上一行 return;，程序将立即崩溃并提示：Fatal error: Uncaught TypeError: logAction(): Return value of logAction() must be of the type void, none returned。
这种严格的约束有助于保持代码意图的清晰性。
立即学习“PHP免费学习笔记（深入）”；
与 null 返回类型的区别
很多开发者会混淆 void 和 null。它们是完全不同的概念。function foo(): null 表示函数必须返回一个 null 值，而 function bar(): void 表示函数根本不返回任何东西。在 PHP 中，void 是比 null 更严格的约束，因为它禁止了任何形式的返回操作。
考虑以下对比：
<?php
// 正确：返回 null
function getNull(): null {
return null;
}
// 错误：void 函数不能返回 null
function getVoid(): void {
return null; // TypeError!
}在实际项目中，如果你希望明确表达“这个函数没有结果”，应优先使用 void。如果你确实需要返回一个空值（例如在某些工厂模式中），则使用 null。选择错误的类型会导致不必要的异常或语义混乱。
匿名函数与闭包中的 void
void 类型不仅适用于命名函数，也完全支持匿名函数和闭包。这在定义回调函数时非常有用，特别是当你传递一个只执行副作用的闭包给其他库（如队列系统或事件监听器）时。
例如，在使用 Laravel 的队列或 Symfony 的事件总线时，你可以这样定义：
<?php
$callback = function (array $data): void {
file_put_contents('/tmp/log.txt', print_r($data, true), FILE_APPEND);
};
// 假设有一个调度器接受回调
$scheduler->addJob($callback); // 安全，因为调度器知道它不会期望返回值这里的关键点是，即使闭包内部没有显式返回，PHP 也会隐式返回 null。但 void 类型声明会忽略这个隐式返回，只要没有显式的 return 语句即可。这使得闭包的意图更加明确。
接口实现中的 void 方法
当你在类中实现接口时，如果接口方法声明了 void 返回类型，子类实现也必须严格遵守。这是 Liskov 替换原则的一部分：子类的方法签名必须兼容父类或接口的签名。
<?php
interface LoggerInterface {
public function log(string $message): void;
}
class FileLogger implements LoggerInterface {
public function log(string $message): void {
file_put_contents('app.log', $message . PHP_EOL, FILE_APPEND);
}
}
// 如果尝试返回任何值，将导致致命错误
// public function log(string $message): void {
// return null; // Fatal Error
// }这种约束确保了所有实现都遵循相同的契约，避免了因返回类型不一致导致的运行时错误。在实际开发中，建议始终为纯副作用函数添加 void 类型，以提高代码的可维护性和可读性。
