php-beast 加密模块编写教程

Question

一，首先创建一个 .c 的文件。例如我们要编写一个使用 base64 加密的模块，可以创建一个名叫 base64_algo_handler.c 的文件。然后在文件添加如下代码：

#include "beast_module.h"

int base64_encrypt_handler(char *inbuf, int len, char **outbuf, int *outlen){
    ...
}

int base64_decrypt_handler(char *inbuf, int len, char **outbuf, int *outlen){
    ...
}

void base64_free_handler(void *ptr){
    ...
}

struct beast_ops base64_handler_ops = {
  .name = "base64-algo",
  .encrypt = base64_encrypt_handler,
  .decrypt = base64_decrypt_handler,
  .free = base64_free_handler,
};

模块必须实现 3 个方法，分别是：encrypt、decrypt、free 方法。

• 1. encrypt 方法负责把 inbuf 字符串加密，然后通过 outbuf 输出给 beast。
• 2. decrypt 方法负责把加密数据 inbuf 解密，然后通过 outbuf 输出给 beast。
• 3. free 方法负责释放 encrypt 和 decrypt 方法生成的数据。

二，写好我们的加密模块后，需要在 global_algo_modules.c 添加我们模块的信息。代码如下：

#include <stdlib.h>
#include "beast_module.h"

extern struct beast_ops des_handler_ops;
extern struct beast_ops base64_handler_ops;

struct beast_ops *ops_handler_list[] = {
  &des_handler_ops,
  &base64_handler_ops, /* 这里是我们的模块信息 */
  NULL,
};

三，修改 config.m4 文件，修改倒数第二行，如下代码：

PHP_NEW_EXTENSION(
beast,
beast.c des_algo_handler.c beast_mm.c spinlock.c cache.c beast_log.c global_algo_modules.c base64_algo_handler.c,
$ext_shared
)

加粗的代码是我们添加的，这里加入的是我们模块的文件名。

现在大功告成了，可以编译试下。如果要使用我们刚编写的加密算法来加密php文件，可以修改 php.ini 文件的配置项，如下：

beast.encrypt_handler = "base64-algo"

名字就是我们模块的name。