# ngx_http_cppjieba_module

**Repository Path**: yanyiwu/ngx_http_cppjieba_module

## Basic Information

- **Project Name**: ngx_http_cppjieba_module
- **Description**: CppJieba 的 Nginx 扩展模块
- **Primary Language**: C
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 7
- **Forks**: 0
- **Created**: 2014-12-13
- **Last Updated**: 2025-06-08

## Categories & Tags

**Categories**: nginx-modules

**Tags**: None

## README

# ngx\_http\_cppjieba\_module

## 简介

[CppJieba] 的 `Nginx` 扩展模块。
需要了解源码的可以参看 [NginxModuleDevelopment] 。

## 支持Docker

```
docker pull docker.cn/yanyiwu/nginx_cppjieba_server
```

## 用法


### 安装和配置

以下用法假设 `ngx_http_cppjieba_module` 下载后存放的地址是 `/tmp/ngx_http_cppjieba_module` (这个地址在 `Nginx` 编译时和词典加载时候会用到)   

#### 下载源码：

```
git clone git://github.com/aszxqw/ngx_http_cppjieba_module.git /tmp/ngx_http_cppjieba_module
```

#### 进入 `Nginx` 源码目录：

```
./configure --add-module=/tmp/ngx_http_cppjieba_module/src
```

因为 `ngx_http_cppjieba_module` 是 `C++` 源码，所以作为 `Nginx` 模块编译的时候需要 修改 `obj/Makefile`

```
# 1. 在 "CC = gcc" 下面增加一行，如下
CXX = g++
# 2. 修改链接器为 g++ ， 如下
LINK = $(CXX)
# 3. 修改 ngx_http_cppjieba_module.cpp 的编译器，从 $(CC) 改为 $(CXX) ， 如下
$(CXX) -c $(CFLAGS)  $(ALL_INCS) \
    -o objs/addon/src/ngx_http_cppjieba_module.o \
    /tmp/ngx_http_cppjieba_module/src/ngx_http_cppjieba_module.cpp

```

这三步做完就可以 `make && sudo make install` nginx 了。

```
# 4. 修改 Nginx 配置文件 /usr/local/nginx/conf/nginx.conf
location /cppjieba {
    cppjieba /tmp/ngx_http_cppjieba_module/dict/jieba.dict.utf8 /tmp/ngx_http_cppjieba_module/dict/hmm_model.utf8 /tmp/ngx_http_cppjieba_module/dict/user.dict.utf8;
}
```

如果 `ngx_http_cppjieba_module` 的源码路径不是 `/tmp/ngx_http_cppjieba_module`， 将上述过程的 `/tmp/xxx` 改为 `/your/path/xxx` 即可。

## 启动 Nginx

```
/usr/local/nginx/sbin/nginx
```

## 测试 

### GET

```
curl "http://127.0.0.1/cppjieba?s=长春市长春药店"
```

### POST

```
curl --data "长春市长春药店" "http://127.0.0.1/cppjieba"
```

预期结果：

```
["长春市", "长春", "药店"]
```

用 `chrome` 打开上述链接也可以，不过要 **记得** 设置浏览器的页面编码方式为 `utf-8` 。


## 客服

`i@yanyiwu.com`

[CppJieba]:https://github.com/aszxqw/cppjieba
[NginxModuleDevelopment]:http://yanyiwu.com/work/2014/09/21/nginx-module-development-stuff.html