WebNet 软件包提供了一个综合的示例页面用于展示软件包的多项功能，包括：AUTH、CGI、ASP、SSI、INDEX、ALIAS、Upload 等功能。本章节主要介绍 WebNet 软件包中各个功能模块示例的使用方式。
示例文件
| 示例程序路径 | 说明 |
|---|---|
| samples/wn_sample.c | 综合示例代码 |
| samples/wn_sample_upload.c | 上传文件示例代码 |
| samples/index.html | 综合示例页面 |
| samples/index.shtml | SSI 功能示例页面 |
| samples/version.asp | ASP 功能示例页面 |
- menuconfig 配置获取软件包和示例代码
打开 RT-Thread 提供的 Env 工具，使用 menuconfig 配置软件包。启用 WebNet 软件包，并配置使能测试例程配置（Enable webnet samples），如下所示：
RT-Thread online packages
IoT - internet of things --->
[*] WebNet: A HTTP Server for RT-Thread
(80) Server listen port ## 服务器监听套接字端口号
(16) Maximum number of server connections ## 服务器最大支持的连接数
(/webnet) Server root directory ## 服务器根目录
Select supported modules ---> ## 默认开启使用的功能模块
[ ] LOG: Enanle output log support
-*- AUTH: Enanle basic HTTP authentication support
-*- CGI: Enanle Common Gateway Interface support
-*- ASP: Enanle Active Server Pages support
-*- SSI: Enanle Server Side Includes support
-*- INDEX: Enanle list all the file in the directory support
-*- ALIAS: Enanle alias support
[ ] DAV: Enanle Web-based Distributed Authoring and Versioning support
-*- UPLOAD: Enanle upload file support
[ ] GZIP: Enable compressed file support by GZIP
(0) CACHE: Configure cache level
[*] Enable webnet samples ## 开启测试例程
Version (latest) --->-
使用
pkgs --update命令下载软件包 -
编译下载
WebNet 软件包示例中需要获取本地静态页面，需要文件系统的支持（FAT 文件系统，ROMFS 文件系统等，只需要支持 RT-Thread 的设备虚拟文件系统）。
静态页面需要上传到文件系统中服务器根目录下（示例中使用根目录为 /webnet）。设备挂载文件系统成功，需要依次执行下面操作：
-
使用
mkdir webnet命令创建 WebNet 软件包根目录 /webnet，并使用cd webnet命令进入该目录； -
使用
mkdir admin和mkdir upload命令创建 /webnet/admin 和 /webnet/upload ，用于 AUTH 功能和 Upload 功能测试； -
将 WebNet 软件包 /sample 目录下的：index.html、index.shtml、version.asp 三个文件依次上传到设备 /webnet 目录（WebNet 根目录）中。（可以使用 TFTP 工具上传文件，具体操作方式参考 TFTP 使用说明)
创建目录和上传文件成功之后，就可以启动例程，测试 WebNet 软件功能。
本例程参数和环境配置如下：
-
监听端口号：80
-
根目录地址：/webnet
-
文件系统：FAT 文件系统
设备启动，连接网络成功之后，在 Shell 命令行输入 webnet_test 命令启动 WebNet 服务器。查看 Shell 命令行，显示如下日志信息，说明 WebNet 服务器初始化成功：
msh />webnet_test
[I/wn] RT-Thread webnet package (V2.0.0) initialize success.然后在 Shell 命令行中使用 ifconfig 命令获取本设备 IP地址为 192.168.12.29。
msh />ifconfig
network interface: w0 (Default)
MTU: 1500
MAC: 44 32 c4 75 e0 59
FLAGS: UP LINK_UP ETHARP BROADCAST IGMP
ip address: 192.168.12.29
gw address: 192.168.10.1
net mask : 255.255.0.0
dns server #0: 192.168.10.1
dns server #1: 223.5.5.5接着在浏览器（这里使用谷歌浏览器）中输入设备 IP 地址，将默认访问设备根目录下 /index.html 文件，如下图所示，页面文件正常显示：
该页面上显示了 WebNet 软件包的基本功能介绍，并根据不同的功能给出相应的演示示例，下面将按顺序介绍如下几个例程：
- AUTH 基本认证例程
- CGI 事件处理例程
- ASP 变量替换例程
- SSI 文件嵌套例程
- INDEX 目录显示例程
- ALIAS 别名访问例程
- Upload 文件上传例程
在例程主页（ /index.html）AUTH Test 模块下点击 基本认证功能测试：用户名及密码为 admin:admin 按键，弹出基本认证对话框，输入用户名 admin，密码 admin。成功输入用户名和密码后，会进入根目录下 /admin 目录，如下图所示流程：
本例程提供两个 CGI 示例：hello world 例程 和 calc 例程 ，用于演示 CGI 事件处理的基本功能。
- hello world 例程
hello world 例程演示了在页面演示文本内容功能，在例程主页 CGI Test 模块下点击 > hello world 按键，会跳转到新页面显示日志信息，新页面显示了 hello world 说明 CGI 事件处理成功，然后在新页面点击 Go back to root 按键回到例程主页面，如下图所示：
- calc 例程
calc 例程中使用 CGI 功能在页面上展示了简单的加法计算器功能，在例程主页 CGI Test 模块下点击 > calc 按键，会跳转到新的页面，输入两个数字点击 计算 按键，页面会显示两数字相加的结果。在新页面点击 Go back to root 按键可以回到例程主页面，如下图所示：
ASP 例程演示了页面变量替换的功能。在例程主页 ASP Test 模块下点击 ASP 功能测试：访问 version.asp 文件 按键，会跳转到根目录下 version.asp 页面，该页面显示当前使用 RT-Thread 系统的版本号。在新页面点击 Go back to root 按键回到例程主页面，如下图所示：
SSI 例程演示在一个页面中嵌套另一个页面的功能。在例程主页 SSI Test 模块下点击 SSI 功能测试：访问 /version.shtml 页面 按键，会跳转到根目录下 index.shtml 页面，该页面中嵌套显示了主页面 index.html 内容。在新页面点击 Go back to root 按键回到例程主页面。
INDEX 例程演示页面文件列表功能。
首先需要任意上传一个文件到根目录的 /admin 目录中，例程中已上传了 admin.txt 文件到该目录中。
然后在例程主页 INDEX Test 模块下点击 INDEX 功能测试：访问/admin 目录 按键，会跳转到根目录下 /admin 目录，并且列出该目录下所有文件名和文件长度，如下图所示：
ALIAS 例程演示了使用目录别名访问该目录的功能。该例程代码中已经将 /test 目录设置别名为 /admin， 在例程主页 ALIAS Test 模块下点击 ALIAS 功能测试：访问 /test 目录会跳转到 /admin 目录 按键，实际我们访问的是 /test 目录，但会跳转访问 /admin 目录，并列出该目录下所有文件信息，如下图所示：
Upload 例程实现上传文件到 WebNet 服务器固定目录功能。在例程主页上 Upload File Test 模块下点击 选择文件 按键，选取需要上传的文件（本例程是用 upload.txt 文件），点击 上传，可以将文件上传到根目录下的 /upload 目录，如下图所示：
文件上传成功之后，返回例程主页，点击 浏览上传文件的目录 按键，可以访问 /upload 文件，查看刚才上传的文件信息。
