Current File : //opt/cloudlinux/alt-php80/root/usr/include/php/ext/swoole/thirdparty/multipart_parser.h |
/* Based on node-formidable by Felix Geisendörfer
* Igor Afonov - afonov@gmail.com - 2012
* MIT License - http://www.opensource.org/licenses/mit-license.php
* @link https://github.com/libcat/libcat/blob/develop/deps/multipart_parser
*/
#ifndef _multipart_parser_h
#define _multipart_parser_h
#ifdef __cplusplus
extern "C" {
#endif
#include <stdio.h>
#include <stdlib.h>
#include <ctype.h>
typedef struct multipart_parser multipart_parser;
typedef struct multipart_parser_settings multipart_parser_settings;
typedef struct multipart_parser_state multipart_parser_state;
typedef int (*multipart_data_cb)(multipart_parser *, const char *at, size_t length);
typedef int (*multipart_notify_cb)(multipart_parser *);
enum multipart_error {
MPPE_OK = 0,
MPPE_PAUSED,
MPPE_UNKNOWN,
MPPE_BOUNDARY_END_NO_CRLF,
MPPE_BAD_START_BOUNDARY,
MPPE_INVALID_HEADER_FIELD_CHAR,
MPPE_INVALID_HEADER_VALUE_CHAR,
MPPE_BAD_PART_END,
MPPE_END_BOUNDARY_NO_DASH,
MPPE_HEADER_VALUE_INCOMPLETE,
};
#define MPPE_ERROR -1
// from RFC2046
#define BOUNDARY_MAX_LEN 70
struct multipart_parser {
/* private holder for callbacks */
const multipart_parser_settings *settings;
/* private internal index for matching boundary */
size_t index;
/* public error unexpected char index */
size_t error_i;
/* private boundary length + 2 ("--") */
unsigned char boundary_length;
FILE *fp;
void *data;
/* private FSM state */
unsigned char state;
/* public error reason */
unsigned char error_reason;
/* private boundary storage: "--" + boundary */
char boundary[(2 + BOUNDARY_MAX_LEN) * 2 + 9];
/* public error expected char */
char error_expected;
/* public error unexpected char */
char error_unexpected;
};
struct multipart_parser_settings {
/*
* data callback called on header field coming
* for example data is "Content-Type" with length 12
*/
multipart_data_cb on_header_field;
/*
* data callback called on header value coming
* for example data is "plain/text" with length 10
*/
multipart_data_cb on_header_value;
/*
* data callback called on body data coming,
* will be called repeatedly until data end
*/
multipart_data_cb on_part_data;
/*
* before "--" boundary
*/
multipart_notify_cb on_part_data_begin;
/*
* after all headers line "\r\n", before body
*/
multipart_notify_cb on_headers_complete;
/*
* after body, before next "--" boundary
*/
multipart_notify_cb on_part_data_end;
/*
* after last "--" boundary "--"
*/
multipart_notify_cb on_body_end;
};
multipart_parser *multipart_parser_init(const char *boundary,
size_t boundary_length,
const multipart_parser_settings *settings);
void multipart_parser_free(multipart_parser *p);
/**
* The multipart header must be complete, otherwise it will be parsed incorrectly
*/
ssize_t multipart_parser_execute(multipart_parser *p, const char *buf, size_t len);
int multipart_parser_error_msg(multipart_parser *p, char *buf, size_t len);
#ifdef __cplusplus
} /* extern "C" */
#endif
#endif