# libgs

**Repository Path**: jin-xiaoqiang/libgs

## Basic Information

- **Project Name**: libgs
- **Description**: 前gts3
cpp20重写
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: dev
- **Homepage**: https://github.com/username-nullptr/libgs
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-02-07
- **Last Updated**: 2025-09-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Cpp, Http

## README

# **HTTP/HTTPS Server and Client**

This is a ASIO/C++20 based http/https library, using the coroutine framework.

------

## Compile and Install

Obtain source code from gitee

```shell
git clone https://gitee.com/jin-xiaoqiang/libgs.git
```

Compile the source code with cmake:

```shell
cd libgs
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=<dir>  # -DCMAKE_CXX_COMPILER=clang++ -DUSE_LIBCXX=yes
make install
```

------

## Compilers :

| Name  |    Version     |              Other              |
| :---: |:--------------:| :-----------------------------: |
|  GNU  | 13.0 or later  |              NULL               |
| Clang | v17.0 or later | std::format needs to be enabled |
| MSVC  | 1930 or later  |       Visual Studio 2022        |

------

## HTTP Server：

```c++
#include <libgs.h>

int main()
{
	spdlog::set_level(spdlog::level::trace);
	asio::ip::tcp::acceptor acceptor(libgs::execution::get_executor());
	constexpr unsigned short port = 12345;

	libgs::http::server server(std::move(acceptor));
	server.bind({asio::ip::tcp::v4(), port})

	.on_request<libgs::http::method::GET>("/*",
	[](libgs::http::server::context &context) -> libgs::awaitable<void>
	{
		auto &request = context.request();
		spdlog::debug("Version:{} - Method:{} - Path:{}",
					  request.version(),
					  libgs::http::to_method_string(request.method()),
					  request.path());

		for(auto &[key,value] : request.parameters())
			spdlog::debug("Parameter: {}: {}", key, value);

		for(auto &[key,value] : request.headers())
			spdlog::debug("Header: {}: {}", key, value);

		for(auto &[key,value] : request.cookies())
			spdlog::debug("Cookie: {}: {}", key, value);

		if( request.can_read_body() )
			spdlog::debug("partial_body: {}\n", co_await request.read(asio::use_awaitable));

		// If you don't write anything, the server will write the default body for you
		// co_await context.response().write("hello world", asio::use_awaitable);
		co_return ;
	})
	.on_request<libgs::http::method::GET>("/aa*bb?cc/{arg0}/{arg1}",
	[](libgs::http::server::context &context) -> libgs::awaitable<void>
	{
		auto &request = context.request();
		for(auto &[key,value] : request.path_args())
			spdlog::debug("Path arg: {}: {}", key, value);

		spdlog::debug("Path arg0: {}", request.path_arg("arg0"));
		spdlog::debug("Path arg[0]: {}", request.path_arg(0));

		spdlog::debug("Path arg1: {}", request.path_arg("arg1"));
		spdlog::debug("Path arg[1]: {}", request.path_arg(1));

		// If you don't write anything, the server will write the default body for you
		// co_await context.response().write("hello world", asio::use_awaitable);
		co_return ;
	})
	.on_request<libgs::http::method::GET>("/hello",
	[](libgs::http::server::context &context) -> libgs::awaitable<void>
	{
//		co_await context.response().write("hello world !!!", asio::use_awaitable);
		co_await context.response()
			.co_send_file("~/hello_world.txt");
//			.co_send_file("C:/Users/Administrator/Desktop/hello_world.txt");
		co_return ;
	})
	.on_service_error([](libgs::http::server::context&, std::exception &ex)
	{
		spdlog::error("on_service_error: {}", ex);
//		return false; // Returning false will result in abort !!!
		return true;
	})
	.on_server_error([](std::error_code error)
	{
		spdlog::error("on_server_error: {}", error);
		libgs::execution::exit(-1);
		return true;
	})
	.start();
    
	spdlog::info("HTTP Server started ({}) ...", port);
	return libgs::execution::exec();
}
```

## HTTPS Server (Requires OpenSSL)：

```c++
// Requires OpenSSL
#define LIBGS_ENABLE_OPENSSL
#include <libgs.h>

int main()
{
	spdlog::set_level(spdlog::level::trace);
	asio::ip::tcp::acceptor acceptor(libgs::execution::get_executor());
	constexpr unsigned short port = 12345;

	// Requires OpenSSL
	using namespace libgs::app::literals;
	asio::ssl::context ssl(asio::ssl::context::sslv23_server);
	try {
		ssl.set_default_verify_paths();
		ssl.set_verify_mode(asio::ssl::context::verify_client_once);
		ssl.set_options(asio::ssl::context::default_workarounds |
						asio::ssl::context::single_dh_use |
						asio::ssl::context::no_sslv2);

		ssl.set_password_callback([](std::size_t, asio::ssl::context::password_purpose){
			return "seri1234";
		});
		ssl.use_certificate_chain_file("~/.ssl/ssl.crt"_abs);
		ssl.use_private_key_file("~/.ssl/ssl.key"_abs, asio::ssl::context::pem);
	}
	catch(std::exception &ex)
	{
		spdlog::error("ssl error: {}", ex);
		return -1;
	}
	libgs::https::server server({std::move(acceptor), ssl});
	server.bind({asio::ip::tcp::v4(), port})

	.on_request<libgs::http::method::GET>("/*",
	[](libgs::https::server::context &context) -> libgs::awaitable<void>
	{
		auto &request = context.request();
		spdlog::debug("Version:{} - Method:{} - Path:{}",
					  request.version(),
					  libgs::http::to_method_string(request.method()),
					  request.path());

		for(auto &[key,value] : request.parameters())
			spdlog::debug("Parameter: {}: {}", key, value);

		for(auto &[key,value] : request.headers())
			spdlog::debug("Header: {}: {}", key, value);

		for(auto &[key,value] : request.cookies())
			spdlog::debug("Cookie: {}: {}", key, value);

		if( request.can_read_body() )
			spdlog::debug("partial_body: {}\n", co_await request.read(asio::use_awaitable));

		// If you don't write anything, the server will write the default body for you
		// co_await context.response().write("hello world", asio::use_awaitable);
		co_return ;
	})
	.on_request<libgs::http::method::GET>("/aa*bb?cc/{arg0}/{arg1}",
	[](libgs::https::server::context &context) -> libgs::awaitable<void>
	{
		auto &request = context.request();
		for(auto &[key,value] : request.path_args())
			spdlog::debug("Path arg: {}: {}", key, value);

		spdlog::debug("Path arg0: {}", request.path_arg("arg0"));
		spdlog::debug("Path arg[0]: {}", request.path_arg(0));

		spdlog::debug("Path arg1: {}", request.path_arg("arg1"));
		spdlog::debug("Path arg[1]: {}", request.path_arg(1));

		// If you don't write anything, the server will write the default body for you
		// co_await context.response().write("hello world", asio::use_awaitable);
		co_return ;
	})
	.on_request<libgs::http::method::GET>("/hello",
	[](libgs::https::server::context &context) -> libgs::awaitable<void>
	{
//		co_await context.response().write("hello world !!!", asio::use_awaitable);
		co_await context.response()
			.co_send_file("~/hello_world.txt");
//			.co_send_file("C:/Users/Administrator/Desktop/hello_world.txt");
		co_return ;
	})
	.on_service_error([](libgs::https::server::context&, std::exception &ex)
	{
		spdlog::error("on_service_error: {}", ex);
//		return false; // Returning false will result in abort !!!
		return true;
	})
	.on_server_error([](std::error_code error)
	{
		spdlog::error("on_server_error: {}", error);
		libgs::execution::exit(-1);
		return true;
	})
	.start();
    
	spdlog::info("HTTPS Server started ({}) ...", port);
	return libgs::execution::exec();
}
```
------

## HTTP Client：

```c++
TODO ...
```

------

## HTTPS Client：

```c++
TODO ...
```