MadelineProto中Sticker构造函数的参数类型问题分析

问题背景

在MadelineProto项目中，EventHandler\Media\Sticker类的构造函数对宽度(width)和高度(height)参数有严格的类型要求，必须为整型(int)。然而在实际使用过程中，当处理某些特殊贴纸时，系统会尝试传入null值，导致类型错误(TypeError)异常。

技术细节

Sticker类的构造函数定义如下：

public function __construct(
    MTProto $API,
    array $rawMedia,
    array $attribute,
    int $width,
    int $height
) {
    // 构造函数实现
}

问题出现在MTProtoTools\Files类中，当处理某些贴纸媒体时，系统会创建一个StaticSticker实例，并传入包含null值的宽度和高度参数。具体来说：

1. 在Files类的第141行，创建了一个包含null值的数组：$has_document_photo = ['w' => null, 'h' => null]
2. 然后在第155行，使用这些值创建StaticSticker实例：return new StaticSticker($this, $media, $attr, $has_document_photo, $protected);

问题影响

当遇到某些特殊格式的贴纸(如示例中的webm格式视频贴纸)时，系统无法正确处理，抛出类型错误异常。这会中断正常的消息处理流程，影响用户体验。

解决方案

正确的做法是将Sticker构造函数的$width和$height参数改为可空类型(nullable)，即修改为?int类型。这样既能保持对普通贴纸的严格类型检查，又能兼容特殊情况下null值的传入。

修改后的构造函数签名应为：

public function __construct(
    MTProto $API,
    array $rawMedia,
    array $attribute,
    ?int $width,
    ?int $height
) {
    // 构造函数实现
}

最佳实践建议

1. 在处理多媒体内容时，特别是来自第三方来源的数据，应该考虑各种可能的边界情况
2. 对于可能不存在的属性，使用可空类型(?type)是更安全的选择
3. 在构造函数中，应该对null值进行适当的处理，或者提供默认值
4. 在文档中明确说明哪些情况下参数可能为null，以及null值的具体含义

总结

这个问题展示了在PHP类型系统中处理可能缺失的数据时需要考虑的边界情况。通过将参数类型改为可空类型，可以增加代码的健壮性，同时保持类型安全。对于MadelineProto这样的即时通讯库来说，处理各种可能的输入情况尤为重要，因为客户端无法控制服务器端发送的数据格式。