php函数通过return语句将计算结果或状态值返回给调用者，同时立即终止当前函数的执行流程。调用方接收返回值后，可将其赋值给变量、直接用于表达式运算，或在条件判断中使用。若函数未显式指定return，默认返回null。
基础语法与数据传递机制
在定义函数时，使用关键字return后跟表达式即可构成返回值。该机制支持标量类型（整数、浮点数、字符串、布尔值）以及复合类型（数组、对象）。当函数体内遇到return语句时，控制权立刻交还给调用位置，后续代码不再执行。
以下是一个完整的PHP程序示例，演示了如何定义一个处理数据的函数并获取其返回结果。此代码展示了基本的数据类型返回及边界情况处理。
立即学习“PHP免费学习笔记（深入）”；
<?php
/**
* 计算两个数的和并返回结果
* @param float $a 第一个数
* @param float $b 第二个数
* @return float 两数之和
*/
function calculateSum(float $a, float $b): float {
// 验证输入是否为有限数值，防止INF或NAN导致逻辑错误
if (!is_finite($a) || !is_finite($b)) {
return 0.0;
}
$result = $a + $b;
// 返回计算结果
return $result;
}
// 调用函数并接收返回值
$sumValue = calculateSum(10.5, 20.3);
// 输出结果
echo "The sum is: " . $sumValue . PHP_EOL;
// 测试边界情况：无效输入
$invalidSum = calculateSum(INF, 5.0);
echo "Invalid input result: " . $invalidSum . PHP_EOL;
?>
上述代码中，calculateSum函数严格限制了参数类型为float，并通过类型声明确保传入值的合法性。函数内部先检查输入是否为有限数值，若包含无穷大或非数字值，则返回0.0作为安全兜底。正常路径下，执行加法运算并通过return将结果传出。调用方通过等号左侧的变量$sumValue捕获该返回值。这种模式适用于所有需要函数提供反馈的场景，如配置读取、数据转换等。
复杂结构与异常处理中的返回策略
对于数组或对象等复杂结构，return同样适用，但需注意引用传递与值传递的区别。在涉及资源操作或可能出错的场景中，通常采用返回状态码结合错误信息的方式，或者抛出异常。这里展示如何通过返回关联数组来携带多重结果。
下面是一个模拟文件读取操作的完整示例，函数尝试打开文件并读取内容，成功时返回包含内容和元数据的数组，失败时返回包含错误信息的数组。这种方式避免了在函数内部直接打印错误信息，保持了函数的纯度和可测试性。
<?php
/**
* 安全读取文件内容
* @param string $filePath 文件路径
* @return array 包含status, data或error的数组
*/
function safeReadFile(string $filePath): array {
// 检查文件是否存在且可读
if (!file_exists($filePath) || !is_readable($filePath)) {
return [
'status' => 'error',
'error' => 'File not found or not readable'
];
}
// 尝试读取文件
$content = @file_get_contents($filePath);
if ($content === false) {
return [
'status' => 'error',
'error' => 'Failed to read file content'
];
}
// 成功时返回数据和状态
return [
'status' => 'success',
'data' => $content,
'size' => strlen($content)
];
}
// 调用示例
$result = safeReadFile('config.json');
if ($result['status'] === 'success') {
echo "Content length: " . $result['size'] . PHP_EOL;
} else {
echo "Error: " . $result['error'] . PHP_EOL;
}
?>
在这个例子中，safeReadFile函数没有使用exit或die中断脚本，而是通过返回结构化数组来传达执行结果。调用方根据status字段判断下一步动作。这种方法提高了代码的模块化程度，使得错误处理逻辑集中在调用层，而非分散在各个函数内部。同时，使用@抑制符隐藏file_get_contents可能的警告，由函数自身统一处理错误信息，避免污染标准输出流。
