PHP 8.2.30
Preview: swoole_websocket.h Size: 5.11 KB
//proc/self/root/opt/cloudlinux/alt-php84/root/usr/include/php/ext/swoole/include/swoole_websocket.h

/*
  +----------------------------------------------------------------------+
  | Swoole                                                               |
  +----------------------------------------------------------------------+
  | This source file is subject to version 2.0 of the Apache license,    |
  | that is bundled with this package in the file LICENSE, and is        |
  | available through the world-wide-web at the following url:           |
  | http://www.apache.org/licenses/LICENSE-2.0.html                      |
  | If you did not receive a copy of the Apache2.0 license and are unable|
  | to obtain it through the world-wide-web, please send a note to       |
  | license@php.net so we can mail you a copy immediately.               |
  +----------------------------------------------------------------------+
  | Author: Tianfeng Han  <rango@swoole.com>                             |
  +----------------------------------------------------------------------+
*/

#pragma once

#include "swoole_http.h"

#define SW_WEBSOCKET_SEC_KEY_LEN 16
#define SW_WEBSOCKET_GUID "258EAFA5-E914-47DA-95CA-C5AB0DC85B11"
#define SW_WEBSOCKET_HEADER_LEN 2
#define SW_WEBSOCKET_MASK_LEN 4
#define SW_WEBSOCKET_MASK_DATA "258E"
#define SW_WEBSOCKET_EXT16_MAX_LEN 0xFFFF
#define SW_WEBSOCKET_EXT16_LENGTH 0x7E
#define SW_WEBSOCKET_EXT64_LENGTH 0x7F
#define SW_WEBSOCKET_CLOSE_CODE_LEN 2
#define SW_WEBSOCKET_CLOSE_REASON_MAX_LEN 125
#define SW_WEBSOCKET_OPCODE_MAX swoole::websocket::OPCODE_PONG
#define SW_WEBSOCKET_FRAME_HEADER_SIZE (SW_WEBSOCKET_HEADER_LEN + SW_WEBSOCKET_MASK_LEN + sizeof(uint64_t))
#define SW_WEBSOCKET_DEFAULT_PAYLOAD_SIZE 1024

namespace swoole {
namespace websocket {

enum Status {
    STATUS_NONE = 0,
    STATUS_CONNECTION = 1,
    STATUS_HANDSHAKE = 2,
    STATUS_ACTIVE = 3,
    STATUS_CLOSING = 4,
    STATUS_HANDSHAKE_FAILED = 5,
};

enum Flag {
    FLAG_FIN = 1 << 0, /* BC: must be 1 */
    FLAG_COMPRESS = 1 << 1,
    // readonly for user
    FLAG_RSV1 = 1 << 2,
    FLAG_RSV2 = 1 << 3,
    FLAG_RSV3 = 1 << 4,
    FLAG_MASK = 1 << 5,
    // for encoder/decoder
    FLAG_ENCODE_HEADER_ONLY = 1 << 6,
    FLAGS_ALL = /* used to prevent overflow  */
    FLAG_FIN | FLAG_RSV1 | FLAG_RSV2 | FLAG_RSV3 | FLAG_MASK | FLAG_COMPRESS
};

struct Header {
    /**
     * fin:1 rsv1:1 rsv2:1 rsv3:1 opcode:4
     */
    uchar OPCODE : 4;
    uchar RSV3 : 1;
    uchar RSV2 : 1;
    uchar RSV1 : 1;
    uchar FIN : 1;
    uchar LENGTH : 7;
    uchar MASK : 1;
};

struct Frame {
    Header header;
    char mask_key[SW_WEBSOCKET_MASK_LEN];
    uint16_t header_length;
    size_t payload_length;
    char *payload;

    uchar get_flags() const {
        uchar flags = 0;
        if (header.FIN) {
            flags |= FLAG_FIN;
        }
        if (header.RSV1) {
            flags |= FLAG_RSV1;
        }
        if (header.RSV2) {
            flags |= FLAG_RSV2;
        }
        if (header.RSV3) {
            flags |= FLAG_RSV3;
        }
        if (header.MASK) {
            flags |= FLAG_MASK;
        }
        return flags;
    }

    bool compressed() const {
        return header.RSV1;
    }
};

#define WEBSOCKET_VERSION 13

enum Opcode {
    OPCODE_CONTINUATION = 0x0,
    OPCODE_TEXT = 0x1,
    OPCODE_BINARY = 0x2,
    OPCODE_CLOSE = 0x8,
    OPCODE_PING = 0x9,
    OPCODE_PONG = 0xa,
};

enum CloseReason {
    CLOSE_NORMAL = 1000,
    CLOSE_GOING_AWAY = 1001,
    CLOSE_PROTOCOL_ERROR = 1002,
    CLOSE_DATA_ERROR = 1003,
    CLOSE_STATUS_ERROR = 1005,
    CLOSE_ABNORMAL = 1006,
    CLOSE_MESSAGE_ERROR = 1007,
    CLOSE_POLICY_ERROR = 1008,
    CLOSE_MESSAGE_TOO_BIG = 1009,
    CLOSE_EXTENSION_MISSING = 1010,
    CLOSE_SERVER_ERROR = 1011,
    CLOSE_SERVICE_RESTART = 1012,
    CLOSE_TRY_AGAIN_LATER = 1013,
    CLOSE_BAD_GATEWAY = 1014,
    CLOSE_TLS = 1015,
};

static inline uint16_t get_ext_flags(uchar opcode, uchar flags) {
    uint16_t ext_flags = opcode;
    ext_flags = ext_flags << 8;
    ext_flags += flags;
    return ext_flags;
}

static inline uchar set_flags(uchar fin, uchar mask, uchar rsv1, uchar rsv2, uchar rsv3) {
    uchar flags = 0;
    if (fin) {
        flags |= FLAG_FIN;
    }
    if (mask) {
        flags |= FLAG_MASK;
    }
    if (rsv1) {
        flags |= FLAG_RSV1;
    }
    if (rsv2) {
        flags |= FLAG_RSV2;
    }
    if (rsv3) {
        flags |= FLAG_RSV3;
    }
    return flags;
}

bool encode(String *buffer, const char *data, size_t length, uint8_t opcode, uint8_t flags);
bool decode(Frame *frame, char *data, size_t length);
void mask(char *data, size_t len, const char *mask_key);
bool pack_close_frame(String *buffer, int code, const char *reason, size_t length, uint8_t flags);
void print_frame(const Frame *frame);

static inline bool decode(Frame *frame, const String *str) {
    return decode(frame, str->str, str->length);
}

static inline void parse_ext_flags(uint16_t ext_flags, uchar *opcode, uchar *flags) {
    *opcode = (uchar) (ext_flags >> 8);
    *flags = (uchar) (ext_flags & 0xFF);
}

ssize_t get_package_length(const Protocol *protocol, network::Socket *conn, PacketLength *pl);
int dispatch_frame(const Protocol *protocol, network::Socket *conn, const RecvData *rdata);

}  // namespace websocket
}  // namespace swoole

Directory Contents

Dirs: 0 × Files: 55

Name Size Perms Modified Actions
26.96 KB lrw-r--r-- 2026-03-18 09:07:57
Edit Download
2.02 KB lrw-r--r-- 2026-03-18 09:07:57
Edit Download
2.31 KB lrw-r--r-- 2026-03-18 09:07:58
Edit Download
3.29 KB lrw-r--r-- 2026-03-18 09:07:58
Edit Download
2.30 KB lrw-r--r-- 2026-03-18 09:07:58
Edit Download
1.30 KB lrw-r--r-- 2026-03-18 09:07:59
Edit Download
2.24 KB lrw-r--r-- 2026-03-18 09:08:00
Edit Download
2.37 KB lrw-r--r-- 2026-03-18 09:08:00
Edit Download
11.75 KB lrw-r--r-- 2026-03-18 09:08:00
Edit Download
8.79 KB lrw-r--r-- 2026-03-18 09:08:01
Edit Download
8.92 KB lrw-r--r-- 2026-03-18 09:08:01
Edit Download
5.12 KB lrw-r--r-- 2026-03-18 09:08:02
Edit Download
4.17 KB lrw-r--r-- 2026-03-18 09:08:03
Edit Download
2.75 KB lrw-r--r-- 2026-03-18 09:08:04
Edit Download
17.64 KB lrw-r--r-- 2026-03-18 09:08:04
Edit Download
3.78 KB lrw-r--r-- 2026-03-18 09:08:04
Edit Download
2.42 KB lrw-r--r-- 2026-03-18 09:08:05
Edit Download
6.46 KB lrw-r--r-- 2026-03-18 09:08:06
Edit Download
4.88 KB lrw-r--r-- 2026-03-18 09:08:06
Edit Download
2.76 KB lrw-r--r-- 2026-03-18 09:08:07
Edit Download
1.24 KB lrw-r--r-- 2026-03-18 09:08:07
Edit Download
1.90 KB lrw-r--r-- 2026-03-18 09:08:07
Edit Download
7.24 KB lrw-r--r-- 2026-03-18 09:08:07
Edit Download
8.55 KB lrw-r--r-- 2026-03-18 09:08:07
Edit Download
5.52 KB lrw-r--r-- 2026-03-18 09:08:07
Edit Download
2.02 KB lrw-r--r-- 2026-03-18 09:08:07
Edit Download
3.25 KB lrw-r--r-- 2026-03-18 09:08:07
Edit Download
15.71 KB lrw-r--r-- 2026-03-18 09:08:08
Edit Download
3.18 KB lrw-r--r-- 2026-03-18 09:08:08
Edit Download
2.83 KB lrw-r--r-- 2026-03-18 09:08:08
Edit Download
5.18 KB lrw-r--r-- 2026-03-18 09:08:08
Edit Download
1.42 KB lrw-r--r-- 2026-03-18 09:08:08
Edit Download
2.16 KB lrw-r--r-- 2026-03-18 09:08:09
Edit Download
1.96 KB lrw-r--r-- 2026-03-18 09:08:10
Edit Download
2.60 KB lrw-r--r-- 2026-03-18 09:08:10
Edit Download
13.17 KB lrw-r--r-- 2026-03-18 09:08:10
Edit Download
5.03 KB lrw-r--r-- 2026-03-18 09:08:11
Edit Download
3.30 KB lrw-r--r-- 2026-03-18 09:08:12
Edit Download
12.40 KB lrw-r--r-- 2026-03-18 09:08:13
Edit Download
1.83 KB lrw-r--r-- 2026-03-18 09:08:13
Edit Download
49.72 KB lrw-r--r-- 2026-03-18 09:08:13
Edit Download
2.99 KB lrw-r--r-- 2026-03-18 09:08:13
Edit Download
18.51 KB lrw-r--r-- 2026-03-18 09:08:14
Edit Download
2.31 KB lrw-r--r-- 2026-03-18 09:08:15
Edit Download
1.43 KB lrw-r--r-- 2026-03-18 09:08:15
Edit Download
5.22 KB lrw-r--r-- 2026-03-18 09:08:15
Edit Download
5.21 KB lrw-r--r-- 2026-03-18 09:08:15
Edit Download
7.32 KB lrw-r--r-- 2026-03-18 09:08:16
Edit Download
6.50 KB lrw-r--r-- 2026-03-18 09:08:16
Edit Download
1.99 KB lrw-r--r-- 2026-03-18 09:08:17
Edit Download
4.37 KB lrw-r--r-- 2026-03-18 09:08:17
Edit Download
3.84 KB lrw-r--r-- 2026-03-18 09:08:17
Edit Download
7.49 KB lrw-r--r-- 2026-03-18 09:08:18
Edit Download
1.74 KB lrw-r--r-- 2026-03-18 09:08:18
Edit Download
5.11 KB lrw-r--r-- 2026-03-18 09:08:18
Edit Download

If ZipArchive is unavailable, a .tar will be created (no compression).