如何在SaloonPHP中自定义异常消息长度限制

SaloonPHP是一个优秀的PHP HTTP客户端库，在处理API请求时提供了完善的异常处理机制。其中RequestException是Saloon中处理请求异常的核心类，但开发者可能会遇到异常消息被截断的问题，因为默认情况下Saloon限制了异常消息长度为200个字符。

问题背景

在Saloon的RequestException类中，异常消息长度被硬编码限制为200个字符。这个设计初衷可能是为了防止过长的错误消息影响日志系统或用户体验，但在某些特定场景下，开发者可能需要获取完整的错误信息来进行调试或特殊处理。

解决方案

方法一：创建自定义异常类

最优雅的解决方案是创建一个自定义异常类来继承RequestException，并重写其构造函数：

class CustomRequestException extends \Saloon\Exceptions\Request\RequestException
{
    public function __construct(Response $response, ?string $message = null, int $code = 0, ?Throwable $previous = null)
    {
        // 使用完整响应体作为消息，或使用传入的自定义消息
        $message = $message ?? $response->body();
        
        // 调用父类构造函数
        parent::__construct($response, $message, $code, $previous);
    }
}

方法二：动态调整最大长度

如果希望保留Saloon原有的消息处理逻辑，只是调整长度限制，可以在子类中修改maxBodyLength属性：

class CustomRequestException extends \Saloon\Exceptions\Request\RequestException
{
    public function __construct(Response $response, ?string $message = null, int $code = 0, ?Throwable $previous = null)
    {
        // 动态设置最大长度为消息实际长度
        $this->maxBodyLength = mb_strlen($message ?? $response->body());
        
        parent::__construct($response, $message, $code, $previous);
    }
}

使用自定义异常

创建自定义异常后，需要在Saloon的请求类中指定使用这个异常：

protected function getRequestException(Response $response, ?string $message = null): RequestException
{
    return new CustomRequestException($response, $message);
}

最佳实践建议

1. 生产环境：建议保留适当的长度限制，过长的错误消息可能包含敏感信息或影响系统性能
2. 开发环境：可以使用完整消息以便调试
3. 日志记录：考虑将完整错误信息记录到日志系统，而不是直接展示给用户
4. 异常处理：在自定义异常中可以添加额外的上下文信息或处理方法

通过这种扩展方式，开发者可以灵活控制异常消息的长度，既保持了Saloon原有的异常处理机制，又能满足特定场景下的需求。