https://github.com/xujintao/ratel
a c/c++ fastcgi based server
https://github.com/xujintao/ratel
boost-libraries cpp17 docker fastcgi jsoncpp travis-ci
Last synced: about 19 hours ago
JSON representation
a c/c++ fastcgi based server
- Host: GitHub
- URL: https://github.com/xujintao/ratel
- Owner: xujintao
- License: mit
- Created: 2017-12-05T08:33:44.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2018-02-03T11:17:25.000Z (over 8 years ago)
- Last Synced: 2025-03-13T20:42:59.446Z (about 1 year ago)
- Topics: boost-libraries, cpp17, docker, fastcgi, jsoncpp, travis-ci
- Language: C++
- Homepage:
- Size: 284 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.org/xujintao/ratel)
Ratel is a api server solution using c/c++:sunglasses:. It is based on spawn-fcgi, fastcgi, fastcgi++, boost and many other libraries which can achieve through github.
## Library
* [spawn-fcgi](https://github.com/lighttpd/spawn-fcgi)
ratel/app fork process via spawn-fcgi.
* [fcgi or fastcgi](https://github.com/LuaDist/fcgi)
A blocking fastcgi based network library. Because of the feature of blocking, Ratel discard, and here just take it to compare with the next non-blocking network library.
* [fastcgi++](https://github.com/eddic/fastcgipp)
A non-blocking fastcgi based network library with c++14, which means our compiler must be support c++14. One receiver-thread(as producer) accept request asynchronously,
and push all request to a container which other multi-thread(act as consumer) pull from and handle.
* log
1.The log module in ratel is based on [boost.log](http://www.boost.org/doc/libs/1_54_0/libs/log/doc/html/index.html), and version must be at least 1.54.0.
2.Instead of verboss "<<", it use printf-style syntax:sunglasses:, which means we can log like this:
```
Log(info, "Num:%d, note:%s", 1, "log here");
```
* [jsoncpp](https://github.com/open-source-parsers/jsoncpp)
Before jsoncpp, i tried [boost.ptree](http://www.boost.org/doc/libs/1_54_0/doc/html/property_tree.html) and [rapidJson](https://github.com/Tencent/rapidjson).
However boost.ptree [does not conform to JSON standard](https://svn.boost.org/trac10/ticket/9721#no2) and rapidJson is extremely clunky to use. As for jsoncpp,
the fact that [Serialize UTF-8 string with Unicode escapes #687](https://github.com/open-source-parsers/jsoncpp/pull/687) since v1.8.4 seems to be useless:disappointed_relieved:.
So, here i will stay with v1.8.3 until it makes some change.
* mysqlwrapper
A [mysql-connector](https://github.com/mysql/mysql-connector-cpp) based sql wrapper which makes mysql easier to use.
## Quick start
On Ubuntu 14.04, start with the following steps:
```sh
# 1. Add toolchain repo:
$ sudo apt-add-repository "ppa:ubuntu-toolchain-r/test"
$ sudo apt-get update
# 2. Install toolchain
$ sudo apt-get install gcc-7 g++-7
# 3. Enable gcc7:
$ sudo ln -s /usr/bin/gcc-7 /usr/bin/gcc -f
$ sudo ln -s /usr/bin/g++-7 /usr/bin/g++ -f
# 4. The default boost repo version on ubuntu 14.04 is 1.54.0:
$ sudo apt-get install libboost-log1.54-dev \
libboost-system1.54-dev \
libboost-thread1.54-dev \
libboost-filesystem1.54-dev
# 5. Install mysql-connector-c++
$ wget https://dev.mysql.com/get/Downloads/Connector-C++/mysql-connector-c++-1.1.9-linux-ubuntu14.04-x86-64bit.tar.gz
$ tar -xzvf mysql-connector-c++-1.1.9-linux-ubuntu14.04-x86-64bit.tar.gz
$ sudo cp -drf mysql-connector-c++-1.1.9-linux-ubuntu14.04-x86-64bit/lib/* /usr/lib
```
If CentOS7.4, you can get started in five steps:
```sh
# 1. Install a package with repository for your system:
$ sudo yum install centos-release-scl-rh
# 2. Install the collection:
$ sudo yum install devtoolset-7-gcc devtoolset-7-gcc-c++ devtoolset-7-gdb
# 3. Start using software collections:
$ source /opt/rh/devtoolset-7/enable
# 4. The default boost from yum on centos7.4 is 1.53.0, we have to download 1.54.0 and build.
$ cd ~
$ wget -q https://sourceforge.net/projects/boost/files/boost/1.54.0/boost_1_54_0.tar.gz
$ tar -xzf boost_1_54_0.tar.gz
$ cd boost_1_54_0
$ ./bootstrap.sh
$ ./b2 --with-log --with-thread --with-system --with-filesystem
$ sudo cp -drf boost /usr/include
$ sudo cp -drf stage/lib/* /usr/lib64
# 5. Install mysql-connector-c++
$ wget https://dev.mysql.com/get/Downloads/Connector-C++/mysql-connector-c++-1.1.9-linux-el7-x86-64bit.tar.gz
$ tar -xzvf mysql-connector-c++-1.1.9-linux-el7-x86-64bit.tar.gz
$ sudo cp -drf mysql-connector-c++-1.1.9-linux-el7-x86-64bit/lib/* /usr/lib64
```
Then, clone and make like this:
```sh
$ git clone https://github.com/xujintao/ratel
$ cd ratel
$ ./build.sh
$ ./restart.sh
```
Now, it should be running well locally. Next we will show how to deploy it to field server by travis-ci.
## Deploy
1. Travis-CI git ratel project clone from github, building with the help of [docker4cpp](https://github.com/xujintao/docker4cpp) container,
and then package all the result directely to test/product server or build runtime images to docker hub.
2. c++ runtime
| runtime | CentOS7.4 | ubuntu14.04 |
| ------ | --------- | ----------- |
| libc | /usr/lib64/libc-2.17.so (2012.12.25) | /lib/x86_64-linux-gnu/libc-2.19.so (2014.2.7) |
| libstdc++(c++11) | /usr/lib64/libstdc++.so.6.0.19 (2014.5.22) | /usr/lib/x86_64-linux-gnu/libstdc++.so.6.0.19 (2014.5.22) |
| libstdc++(c++17) | /opt/rh/devtoolset-7/.../x86_64-redhat-linux/7/* (2017-12-25) | /usr/lib/x86_64-linux-gnu/libstdc++.so.6.0.24 (2017.8.20) |
> [GCC Development Plan](https://gcc.gnu.org/develop.html)
> [ABI Policy and Guidelines](https://gcc.gnu.org/onlinedocs/libstdc++/manual/abi.html)
## License
[MIT](https://github.com/xujintao/ratel/blob/master/LICENSE)