基础知识

#include<stdio.h>
#include<signal.h>
#include<unistd.h>
#include<stdlib.h>
#include<string.h>

void signal_handler(int signo);

// 通过这种方式，程序能够在每 10 秒挂起等待信号到达，并在信号到达时进行相应处理。这样可以在处理长时间运行任务时，响应用户发送的中断信号
int main(void){
    //设置信号掩码，屏蔽信号：SIGINT（2 非可靠信号Ctrl+C )、SIGRTMIN(34 可靠信号）
    sigset_t set;
    sigemptyset(&set); // 清除集合中的所有信号
    sigaddset(&set, SIGINT); // 添加 SIGINT 到 集合
    sigaddset(&set, SIGRTMIN); // 添加 SIGRTMIN 到 集合
    /*
    int how: 指定如何修改信号屏蔽字，有以下几种取值：

        SIG_BLOCK: 将 set 中指定的信号加入到当前信号屏蔽字中，即阻塞这些信号。
        SIG_UNBLOCK: 从当前信号屏蔽字中移除 set 中指定的信号，即解除阻塞这些信号。
        SIG_SETMASK: 将当前信号屏蔽字设置为 set 指定的信号集。

    const sigset_t *set: 指向一个 sigset_t 类型的信号集，该信号集指定要修改的信号。

    sigset_t *oldset: 如果不为 NULL，则存储修改之前的信号屏蔽字。
     */
    sigprocmask(SIG_BLOCK, &set, NULL);

    //为以下信号安装信号处理器：SIGINT（2 非可靠信号 Ctrl+C )、SIGRTMIN(34 可靠信号）、
    //SIGQUIT（3 非可靠信号 Ctrl+\）
    struct sigaction sa;
    memset(&sa,0, sizeof(struct sigaction)); // 清零
    sa.sa_handler = signal_handler; // 设置信号处理程序
    sigemptyset(&sa.sa_mask); // 清空信号屏蔽集
    sigaction(SIGINT, &sa, NULL); // 将 SIGINT 信号与 sa 结构体中的信号处理程序关联起来
    sigaction(SIGRTMIN, &sa, NULL); // 将 SIGRTMIN 信号与 sa 结构体中的信号处理程序关联起来
    sigaction(SIGQUIT, &sa, NULL); // 将 SIGQUIT 信号与 sa 结构体中的信号处理程序关联起来

    int count = 0;
    while(1){
        if(count >= 100){ //休眠100s后，退出
            break;
        }
        printf("sleep ..\n");
        sleep(1);
        if(count > 0 && count%10 == 0){
            //每10s，接收一次信号，接收之后继续屏蔽信号 SIGINT、SIGRTMIN
            printf("挂起等待信号．.\n");
            sigemptyset(&set); // 清除集合中的所有信号
            // sigsuspend 会解除对 SIGINT 和 SIGRTMIN 的屏蔽，并挂起进程，直到信号到达并被处理。
            // 处理完信号后，sigsuspend 返回并继续屏蔽这些信号
            sigsuspend(&set);
        }
        count++;
    }
}

void signal_handler(int signo){
    //由于信号掩码的设置，该信号处理器被调用的时候，不会被SIGINT、SIGRTMIN打断、干扰
    if(signo == SIGINT){
        printf("catch signal SIGINT:%d\n", signo);
    }else if(signo == SIGRTMIN){
        printf("catch signal SIGRTMIN:%d\n", signo);
    }else if(signo == SIGQUIT){
        printf("catch signal SIGQUIT:%d, exit..\n", signo);
        exit(0);
    }else{
        printf("catch signal :%d\n", signo);
    }
}

struct _sapi_module_struct {
    char *name; // 名字，如cli、 fpm-fcgi等
    char *pretty_name; // 更易理解的名字，比如fpm-fcgi对应的为FPM/FastCGI
    int (*startup)(struct _sapi_module_struct *sapi_module);
    //模块启动时调用的函数
    int (*shutdown)(struct _sapi_module_struct *sapi_module);
    //模块结束时调用的函数
    int (*activate)(void); // 处理request时，激活需要调用的函数指针
    int (*deactivate)(void); // 处理完request时，使要调用的函数指针无效
    size_t (*ub_write)(const char *str, size_t str_length);
    // 这个函数指针用于输出数据
    void (*flush)(void *server_context); // 刷新缓存的函数指针
    zend_stat_t *(*get_stat)(void); // 判断对执行文件是否有执行权限
    char *(*getenv)(char *name, size_t name_len); // 获取环境变量的函数指针
    void (*sapi_error)(int type, const char *error_msg, ...)
        ZEND_ATTRIBUTE_FORMAT(printf, 2, 3); // 错误处理函数指针
    int (*header_handler)(sapi_header_struct *sapi_header,
        sapi_header_op_enum op, sapi_headers_struct *sapi_headers);
        //调用header()时被调用的函数指针
    int (*send_headers)(sapi_headers_struct *sapi_headers);
    // 发送全部header的函数指针
    void (*send_header)(sapi_header_struct *sapi_header, void *server_context);
    // 发送某一个header的函数指针
    size_t (*read_post)(char *buffer, size_t count_bytes);
    // 获取HTTP POST中数据的函数指针
    char *(*read_cookies)(void);  // 获取cookie中数据的函数指针
    void (*register_server_variables)(zval *track_vars_array);
    // 从$_SERVER中获取变量的函数指针
    void (*log_message)(char *message, int syslog_type_int);
    // 输出错误信息函数指针
    double (*get_request_time)(void); // 获取请求时间的函数指针
    void (*terminate_process)(void);  // 调用exit退出时的函数指针
    char *php_ini_path_override;  // PHP的ini文件被复写的地址

    void (*default_post_reader)(void); //负责解析POST数据的函数指针
    void (*treat_data)(int arg, char *str, zval *destArray);
    // 对数据进行处理的函数指针
    char *executable_location; // 执行的地理位置
    int php_ini_ignore; // 是否不使用任何ini配置文件
    int php_ini_ignore_cwd; // 忽略当前路径的php.ini
    int (*get_fd)(int *fd); // 获取执行文件的fd的函数指针
    int (*force_http_10)(void); // 强制使用http 1.0版本的函数指针
    int (*get_target_uid)(uid_t *); // 获取执行程序的uid的函数指针
    int (*get_target_gid)(gid_t *); // 获取执行程序的gid的函数指针
    unsigned int (*input_filter)(int arg, char *var, char **val, size_t val_len,
        size_t *new_val_len);
    // 对输入进行过滤的函数指针。比如将输入参数填充到自动全局变量$_GET、$_POST、$_COOKIE中
    void (*ini_defaults)(HashTable *configuration_hash);
    // 默认的ini配置的函数指针，把ini配置信息存在HashTable中
    int phpinfo_as_text; // 是否输出phpinfo信息

    char *ini_entries; // 执行时附带的ini配置，可以使用php -d设置
    const zend_function_entry *additional_functions;
    // 每个SAPI模块特有的一些函数注册，比如cli的cli_get_process_title
    unsigned int (*input_filter_init)(void);
};

static sapi_module_struct cgi_sapi_module = {
    "fpm-fcgi",
    "FPM/FastCGI",
    ……

static sapi_module_struct cli_sapi_module = {
    "cli",
    "Command Line Interface",
    ……

static char *sapi_cgi_read_cookies(void) /* {{{ */
{
    fcgi_request *request = (fcgi_request*) SG(server_context);

    return FCGI_GETENV(request, "HTTP_COOKIE");
}

# define SG(v) (sapi_globals.v)