本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# coreHTTP 库
<a name="core-http"></a>

**注意**  <a name="out-of-date-message"></a>
此页面上的内容可能不是最新的。有关最新更新，请参阅 [FreeRTOS.org 库页面](https://www.freertos.org/Documentation/03-Libraries/01-Library-overview/01-All-libraries)。

**适用于小型 IoT 设备（MCU 或小型 MPU）的 HTTP C 客户端库**

## 简介
<a name="core-http-introduction"></a>

coreHTTP 库是 [HTTP/1.1](https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol) 标准子集的客户端实现。HTTP 标准提供了一种在 TCP/IP 上运行的无状态协议，通常用于分布式、协作式的超文本信息系统。

coreHTTP 库实现了 [HTTP/1.1](https://tools.ietf.org/html/rfc2616) 协议标准的子集。该库已针对低内存占用空间进行了优化。该库提供了一个完全同步的 API，因此应用程序可以完全管理其并发性。它仅使用固定缓冲区，因此应用程序可以完全控制其内存分配策略。

该库使用 C 语言编写，设计符合 [ISO C90](https://en.wikipedia.org/wiki/ANSI_C#C90) 和 [MISRA C:2012](https://misra.org.uk/product/misra-c2012-third-edition-first-revision/)。该库的唯一依赖项是标准 C 库和 Node.js 的 [http-parser 的 LTS 版本 (v12.19.1)](https://github.com/nodejs/node/tree/v12.19.1/deps/http_parser)。该库有[证据](https://www.cprover.org/cbmc/)表明内存使用安全，没有堆分配，因此适用于 IoT 微控制器，但也完全可移植到其他平台。

在 IoT 应用中使用 HTTP 连接时，我们建议您使用安全的传输接口，例如，使用 TLS 协议的接口，如中 [coreHTTP 双向身份验证演示](core-http-ma-demo.md)所示。

该库可免费使用，并根据 [MIT 开源许可证](https://freertos.org/a00114.html)分发。


****  

| coreHTTP 的代码大小（使用 GCC for ARM Cortex-M 生成的示例） | 文件 | 使用 -O1 优化 | 使用 -Os 优化 | 
| --- | --- | --- | --- | 
| core\$1http\$1client.c | 3.2K | 2.6K | 
| api.c (llhttp) | 2.6K | 2.0K | 
| http.c (llhttp) | 0.3K | 0.3K | 
| http.c (llhttp) | 17.9 | 15.9 | 
| 估计总数 | 23.9K | 20.7K |