civetweb
v1.16
published 1 year ago
3,004 stars
976 forks
127 watchers
Other
public
1 assets
3,870 downloads
952 KB
Compatibility level 1
8ORxwb9OeASmz7QeqdE+fWI7K8x7weKk3VSVGiTWAoU=
v1.16
April 10, 2023

Summary

bug fixes, documentation and examples, WebDAV

Changes

  • Enable IPv6 as default when using CMake
  • Define error codes for mg_start2, mg_start_domain2, mg_connect_client2
  • Fixes for OpenSSL 3.0 support
  • Add support for Mbed TLS v3.0.0
  • WebDAV should understand Windows File Explorer (experimental)
  • Accept HTTP basic authentication
  • FreeBSD support, including CI and tests
  • Make pattern matching function availible in the public interface
  • Make base64 encoding and decoding functions available
  • Various fixes for HTTP/2 support
  • Additional examples
  • Fixes and updates to existing examples
  • Fix spelling errors in code and documentation
  • Remove Conan support
  • Update version number

Note: A pre-compiled 32-bit executables for Windows is no longer provided, but only a 64 bit Windows executable. The source code itself still supports 32-bit platforms.

Known Issues

The WebDAV support when using the Windows Explorer as client has various limitations when renaming or moving files and folders. In particular file names in non-latin characters may break when running the server on Linux and connecting with the Windows Explorer.

Deps:
    Assets:

    CivetWeb CivetWeb

    The official home of CivetWeb is on GitHub https://github.com/civetweb/civetweb

    License GitHub contributors Stargazers Forks Latest Release

    Continuous integration for Linux and macOS (Travis CI):

    Travis Build Status

    Continuous integration for Windows (AppVeyor):

    Appveyor Build Status

    Test coverage check (coveralls, codecov) (using different tools/settings):

    Coveralls Coverage Status codecov

    Static source code analysis (Coverity): Coverity Scan Build Status

    CodeQL semantic code analysis: CodeQL

    Project Mission

    Project mission is to provide easy to use, powerful, C (C/C++) embeddable web server with optional CGI, SSL and Lua support. CivetWeb has a MIT license so you can innovate without restrictions.

    CivetWeb can be used by developers as a library, to add web server functionality to an existing application.

    It can also be used by end users as a stand-alone web server running on a Windows or Linux PC. It is available as single executable, no installation is required.

    Where to find the official version?

    End users can download CivetWeb binaries / releases from here on GitHub https://github.com/civetweb/civetweb/releases or SourceForge https://sourceforge.net/projects/civetweb/

    Developers can contribute to CivetWeb via GitHub https://github.com/civetweb/civetweb

    Due to a bug in Git for Windows V2.24 CivetWeb must be used with an earlier or later version (see also here).

    Bugs and requests should be filed on GitHub https://github.com/civetweb/civetweb/issues

    New releases are announced on Google Groups https://groups.google.com/d/forum/civetweb

    Formerly some support question and discussion threads have been at Google groups. Recent questions and discussions use GitHub issues.

    Source releases can be found on GitHub https://github.com/civetweb/civetweb/releases

    A very brief overview can be found on GitHub Pages https://civetweb.github.io/civetweb/

    Quick start documentation

    Overview

    CivetWeb keeps the balance between functionality and simplicity by a carefully selected list of features:

    • Forked from Mongoose in 2013, before it changed the licence from MIT to commercial + GPL. A lot of enhancements have been added since then, see RELEASE_NOTES.md.
    • Maintains the liberal, permissive, commercial-friendly, MIT license
    • Project is free from copy-left licenses, like GPL, because you should innovate without restrictions.
    • Works on Windows, Mac, Linux, UNIX, IOS, Android, Buildroot, and many other platforms.
    • Scripting and database support (CGI, Lua Server Pages, Server side Lua scripts, Lua SQLite database, Server side JavaScript). This provides a ready to go, powerful web development platform in a one single-click executable with no dependencies. 0
    • Support for CGI, SSI, HTTP digest (MD5) authorization, WebSocket, WebDAV.
    • Experimental HTTP/2 support.
    • HTTPS (SSL/TLS) support using OpenSSL.
    • Optional support for authentication using client side X.509 certificates.
    • Resumed download, URL rewrite, file blacklist, IP-based ACL.
    • Can run as a Windows service or systemd service.
    • Download speed limit based on client subnet or URI pattern.
    • Simple and clean embedding API.
    • The source is in single file for drop in compilation.
    • Embedding examples included.
    • HTTP client capable of sending arbitrary HTTP/HTTPS requests.
    • Websocket client functionality available (WS/WSS).

    Optionally included software

    Lua LuaFileSystem LuaSQLite3 Sqlite3 LuaXML Duktape

    Optional dependencies

    zlib

    OpenSSL

    Mbed TLS

    GNU TLS

    Support

    This project is very easy to install and use. Please read the documentation and have a look at the examples.

    Recent questions and discussions usually use GitHub issues. Some old information may be found on the mailing list, but this information may be outdated.

    Feel free to create a GitHub issue for bugs, feature requests, questions, suggestions or if you want to share tips and tricks. When creating an issues for a bug, add enough description to reproduce the issue - at least add CivetWeb version and operating system. Please see also the guidelines for Contributions and the Security Policy

    Note: We do not take any liability or warranty for any linked contents. Visit these pages and try the community support suggestions at your own risk. Any link provided in this project (including source and documentation) is provided in the hope that this information will be helpful. However, we cannot accept any responsibility for any content on an external page.

    Contributions

    Contributions are welcome provided all contributions carry the MIT license.

    DO NOT APPLY fixes copied from Mongoose to this project to prevent GPL tainting. Since 2013, CivetWeb and Mongoose have been developed independently. By now the code base differs, so patches cannot be safely transferred in either direction.

    Some guidelines can be found in docs/Contribution.md.

    Authors

    CivetWeb was forked from the last MIT version of Mongoose in August 2013. Since then, CivetWeb has seen many improvements from various authors (Copyright (c) 2013-2021 the CivetWeb developers, MIT license).

    A list of authors can be found in CREDITS.md.

    CivetWeb is based on the Mongoose project. The original author of Mongoose was Sergey Lyubka(2004-2013) who released it under the MIT license. However, on August 16, 2013, Mongoose was relicensed to a dual GPL V2 + commercial license and CiwetWeb was created by Thomas Davis (sunsetbrew) as "the MIT fork of mongoose". The license change and CivetWeb fork was mentioned on the Mongoose Wikipedia page as well, but it's getting deleted (and added again) there every now and then.

    Using the CivetWeb project ensures the MIT licenses terms are applied and GPL cannot be imposed on any of this code, as long as it is sourced from here. This code will remain free with the MIT license protection.