如何在PHP函数中实现多级返回？API通用校验场景优化方案

假设我们有一个名为phone.add的API方法，终端用户可通过http://example.com/api/v1/phone.add携带参数调用该接口。在执行PhoneManager类中的实际业务函数前，需完成两项通用检查：参数校验与权限验证。

当前的phone_add函数示例如下：

function phone_add(string $param1, int $param2, callable $param3): float { 
    //... validate $param1, $param2, $param3 
    //... check access rights 
    //... call PhoneManager::add() 
    //... return result 
}

显然参数校验可能失败，此时需生成并返回对应响应，但在每个API方法中添加if (validation_failed(...)) return new Response(...)的写法过于繁琐。因此想请教：如何从嵌套函数返回实际的最终响应，或者该如何正确实现这一校验执行流程？

解决方案：几种优雅的实现思路 #

我来给你分享几个实用的方案，帮你摆脱每个接口里重复写校验、权限判断和响应返回的繁琐工作：

1. 中间件模式（推荐用于Web框架场景） #

如果你的API是基于Web框架开发的，中间件绝对是处理这类通用逻辑的最优解。它就像一个「前置关卡」，所有请求在到达你的业务函数之前，都会先经过中间件完成校验和权限检查，校验不通过直接返回响应，完全不用侵入业务代码。

举个PHP的示例（参考Laravel这类框架的思路）：

// 定义参数校验+权限验证的中间件
class ValidatePhoneAddMiddleware {
    public function handle($request, Closure $next) {
        // 1. 参数校验
        $validator = Validator::make($request->all(), [
            'param1' => 'required|string',
            'param2' => 'required|integer',
            // 针对callable类型可以自定义校验规则
        ]);

        if ($validator->fails()) {
            return response()->json(['error' => $validator->errors()], 400);
        }

        // 2. 权限验证
        if (!auth()->user()->hasPermission('phone_add')) {
            return response()->json(['error' => '无操作权限'], 403);
        }

        // 校验通过，放行到业务函数
        return $next($request);
    }
}

// 在路由中绑定中间件，指定哪些接口需要经过这个关卡
Route::post('/api/v1/phone.add', 'PhoneController@add')->middleware(ValidatePhoneAddMiddleware::class);

// 业务控制器里只需要专注核心逻辑
class PhoneController {
    public function add(Request $request) {
        $result = PhoneManager::add(
            $request->param1,
            $request->param2,
            $request->param3
        );
        return response()->json(['data' => $result]);
    }
}

2. 装饰器模式（适合独立函数场景） #

如果你的接口是基于独立函数而非框架控制器，可以用装饰器来包裹业务函数，把校验逻辑完全抽离出来，实现逻辑解耦。

示例代码：

// 定义一个校验装饰器，专门用来包裹phone_add这类业务函数
function validatePhoneAddDecorator(callable $businessFunc) {
    return function($param1, $param2, $param3) use ($businessFunc) {
        // 参数校验逻辑
        if (!is_string($param1)) {
            return new Response('param1必须为字符串类型', 400);
        }
        if (!is_int($param2)) {
            return new Response('param2必须为整数类型', 400);
        }
        // 权限检查逻辑
        if (!checkCurrentUserAccessRights()) {
            return new Response('您无此操作权限', 403);
        }

        // 所有校验通过，执行核心业务逻辑
        $result = $businessFunc($param1, $param2, $param3);
        return new Response(json_encode(['data' => $result]), 200);
    };
}

// 纯核心业务逻辑的函数，完全不掺杂校验代码
function phone_add_core(string $param1, int $param2, callable $param3): float {
    return PhoneManager::add($param1, $param2, $param3);
}

// 用装饰器包裹业务函数，得到一个带校验能力的新函数
$phone_add = validatePhoneAddDecorator('phone_add_core');

// 调用时直接使用包裹后的函数即可
$response = $phone_add($param1, $param2, $param3);

你可以给不同的API函数创建对应的装饰器，甚至可以写通用装饰器来复用大部分校验逻辑。

3. 异常处理机制（统一捕获校验失败） #

如果不想用中间件或装饰器，也可以通过抛出异常的方式，在统一的入口处捕获异常并生成响应，避免在每个函数里写重复的return语句。

示例：

// 自定义校验失败异常类
class ValidationFailedException extends Exception {
    protected $statusCode = 400;
    public function __construct($message) {
        parent::__construct($message);
    }
    public function getStatusCode() {
        return $this->statusCode;
    }
}

// 自定义权限异常类
class AccessDeniedException extends Exception {
    protected $statusCode = 403;
    public function __construct($message) {
        parent::__construct($message);
    }
    public function getStatusCode() {
        return $this->statusCode;
    }
}

// 业务函数中只需要在校验失败时抛出异常
function phone_add(string $param1, int $param2, callable $param3) {
    // 参数校验
    if (!is_string($param1)) {
        throw new ValidationFailedException('param1必须为字符串类型');
    }
    if (!is_int($param2)) {
        throw new ValidationFailedException('param2必须为整数类型');
    }
    // 权限检查
    if (!checkCurrentUserAccessRights()) {
        throw new AccessDeniedException('您无此操作权限');
    }

    return PhoneManager::add($param1, $param2, $param3);
}

// 在API入口处统一捕获异常并生成响应
try {
    $result = phone_add($param1, $param2, $param3);
    $response = new Response(json_encode(['data' => $result]), 200);
} catch (ValidationFailedException | AccessDeniedException $e) {
    $response = new Response(json_encode(['error' => $e->getMessage()]), $e->getStatusCode());
}

这种方式把校验失败的逻辑转化为异常，让业务函数更简洁，所有异常统一处理，也方便后续扩展其他异常类型。

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