@colin4k1024/tsp 2.4.0

package/skills/goframe-v2/examples/httpserver/upload-file/README.ZH.MD

@@ -0,0 +1,47 @@
+---
+title: 文件上传
+slug: /examples/httpserver/upload-file
+keywords: [http, 服务器, 文件, 上传, goframe]
+description: 演示在GoFrame HTTP服务器中处理文件上传用于多部分表单数据处理。本示例展示了单文件和多文件上传支持、多部分表单数据解析和处理、文件大小验证和限制、带有MIME类型检查的文件类型验证、带有唯一命名的安全文件存储、以及与GoFrame请求处理集成。主要功能包括:自动文件解析、可配置的上传限制、文件元数据提取、进度跟踪支持、无效上传的错误处理、生产级模式。非常适合构建文件上传API和表单、实现图像和文档上传功能、处理批量文件上传、确保安全的文件处理、以及创建内容管理系统。通过本示例可以学习文件上传的最佳实践、安全文件处理、以及构建安全可靠的文件上传功能。
+hide_title: true
+sidebar_position: 3
+---
+
+# HTTP 服务器文件上传
+
+## 介绍
+
+本示例展示了如何使用 `GoFrame` 在 HTTP 服务器中实现文件上传功能。它展示了：
+- 现代化且用户友好的文件上传界面
+- 服务器端文件上传处理
+- 文件上传进度跟踪
+- 适当的错误处理和验证
+- 最大文件大小配置
+
+本示例同时提供了 `REST API` 端点和 `Web` 界面用于文件上传。
+
+## 环境要求
+
+- [Go](https://golang.org/dl/) `1.22` 或更高版本
+- [Git](https://git-scm.com/downloads)
+- [GoFrame](https://goframe.org)
+
+## 目录结构
+
+- `go.mod`: Go 模块文件，用于依赖管理
+- `main.go`: 主程序入口
+- `resource/`: 静态资源目录
+  - `public/`: 公共资源
+    - `upload.html`: 上传页面
+  - `upload/`: 上传文件存储目录
+
+## 使用说明
+
+1. 启动服务：
+   ```bash
+   go run main.go
+   ```
+
+2. 上传页面：http://localhost:8000/upload.html
+
+

package/skills/goframe-v2/examples/httpserver/upload-file/go.mod

@@ -0,0 +1,35 @@
+module main
+
+go 1.23.0
+
+require github.com/gogf/gf/v2 v2.10.0
+
+require (
+	github.com/BurntSushi/toml v1.5.0 // indirect
+	github.com/clbanning/mxj/v2 v2.7.0 // indirect
+	github.com/emirpasic/gods/v2 v2.0.0-alpha // indirect
+	github.com/fatih/color v1.18.0 // indirect
+	github.com/fsnotify/fsnotify v1.9.0 // indirect
+	github.com/go-logr/logr v1.4.3 // indirect
+	github.com/go-logr/stdr v1.2.2 // indirect
+	github.com/google/uuid v1.6.0 // indirect
+	github.com/gorilla/websocket v1.5.3 // indirect
+	github.com/grokify/html-strip-tags-go v0.1.0 // indirect
+	github.com/magiconair/properties v1.8.10 // indirect
+	github.com/mattn/go-colorable v0.1.13 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/mattn/go-runewidth v0.0.16 // indirect
+	github.com/olekukonko/errors v1.1.0 // indirect
+	github.com/olekukonko/ll v0.0.9 // indirect
+	github.com/olekukonko/tablewriter v1.1.0 // indirect
+	github.com/rivo/uniseg v0.2.0 // indirect
+	go.opentelemetry.io/auto/sdk v1.1.0 // indirect
+	go.opentelemetry.io/otel v1.38.0 // indirect
+	go.opentelemetry.io/otel/metric v1.38.0 // indirect
+	go.opentelemetry.io/otel/sdk v1.38.0 // indirect
+	go.opentelemetry.io/otel/trace v1.38.0 // indirect
+	golang.org/x/net v0.40.0 // indirect
+	golang.org/x/sys v0.35.0 // indirect
+	golang.org/x/text v0.25.0 // indirect
+	gopkg.in/yaml.v3 v3.0.1 // indirect
+)

package/skills/goframe-v2/examples/httpserver/upload-file/go.sum

@@ -0,0 +1,81 @@
+github.com/BurntSushi/toml v1.5.0 h1:W5quZX/G/csjUnuI8SUYlsHs9M38FC7znL0lIO+DvMg=
+github.com/BurntSushi/toml v1.5.0/go.mod h1:ukJfTF/6rtPPRCnwkur4qwRxa8vTRFBF0uk2lLoLwho=
+github.com/clbanning/mxj/v2 v2.7.0 h1:WA/La7UGCanFe5NpHF0Q3DNtnCsVoxbPKuyBNHWRyME=
+github.com/clbanning/mxj/v2 v2.7.0/go.mod h1:hNiWqW14h+kc+MdF9C6/YoRfjEJoR3ou6tn/Qo+ve2s=
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/emirpasic/gods/v2 v2.0.0-alpha h1:dwFlh8pBg1VMOXWGipNMRt8v96dKAIvBehtCt6OtunU=
+github.com/emirpasic/gods/v2 v2.0.0-alpha/go.mod h1:W0y4M2dtBB9U5z3YlghmpuUhiaZT2h6yoeE+C1sCp6A=
+github.com/fatih/color v1.18.0 h1:S8gINlzdQ840/4pfAwic/ZE0djQEH3wM94VfqLTZcOM=
+github.com/fatih/color v1.18.0/go.mod h1:4FelSpRwEGDpQ12mAdzqdOukCy4u8WUtOY6lkT/6HfU=
+github.com/fsnotify/fsnotify v1.9.0 h1:2Ml+OJNzbYCTzsxtv8vKSFD9PbJjmhYF14k/jKC7S9k=
+github.com/fsnotify/fsnotify v1.9.0/go.mod h1:8jBTzvmWwFyi3Pb8djgCCO5IBqzKJ/Jwo8TRcHyHii0=
+github.com/go-logr/logr v1.2.2/go.mod h1:jdQByPbusPIv2/zmleS9BjJVeZ6kBagPoEUsqbVz/1A=
+github.com/go-logr/logr v1.4.3 h1:CjnDlHq8ikf6E492q6eKboGOC0T8CDaOvkHCIg8idEI=
+github.com/go-logr/logr v1.4.3/go.mod h1:9T104GzyrTigFIr8wt5mBrctHMim0Nb2HLGrmQ40KvY=
+github.com/go-logr/stdr v1.2.2 h1:hSWxHoqTgW2S2qGc0LTAI563KZ5YKYRhT3MFKZMbjag=
+github.com/go-logr/stdr v1.2.2/go.mod h1:mMo/vtBO5dYbehREoey6XUKy/eSumjCCveDpRre4VKE=
+github.com/gogf/gf/v2 v2.10.0 h1:rzDROlyqGMe/eM6dCalSR8dZOuMIdLhmxKSH1DGhbFs=
+github.com/gogf/gf/v2 v2.10.0/go.mod h1:Svl1N+E8G/QshU2DUbh/3J/AJauqCgUnxHurXWR4Qx0=
+github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
+github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
+github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/gorilla/websocket v1.5.3 h1:saDtZ6Pbx/0u+bgYQ3q96pZgCzfhKXGPqt7kZ72aNNg=
+github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE=
+github.com/grokify/html-strip-tags-go v0.1.0 h1:03UrQLjAny8xci+R+qjCce/MYnpNXCtgzltlQbOBae4=
+github.com/grokify/html-strip-tags-go v0.1.0/go.mod h1:ZdzgfHEzAfz9X6Xe5eBLVblWIxXfYSQ40S/VKrAOGpc=
+github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE=
+github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk=
+github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
+github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
+github.com/magiconair/properties v1.8.10 h1:s31yESBquKXCV9a/ScB3ESkOjUYYv+X0rg8SYxI99mE=
+github.com/magiconair/properties v1.8.10/go.mod h1:Dhd985XPs7jluiymwWYZ0G4Z61jb3vdS329zhj2hYo0=
+github.com/mattn/go-colorable v0.1.13 h1:fFA4WZxdEF4tXPZVKMLwD8oUnCTTo08duU7wxecdEvA=
+github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg=
+github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/yFXSvRLM=
+github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
+github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/mattn/go-runewidth v0.0.16 h1:E5ScNMtiwvlvB5paMFdw9p4kSQzbXFikJ5SQO6TULQc=
+github.com/mattn/go-runewidth v0.0.16/go.mod h1:Jdepj2loyihRzMpdS35Xk/zdY8IAYHsh153qUoGf23w=
+github.com/olekukonko/errors v1.1.0 h1:RNuGIh15QdDenh+hNvKrJkmxxjV4hcS50Db478Ou5sM=
+github.com/olekukonko/errors v1.1.0/go.mod h1:ppzxA5jBKcO1vIpCXQ9ZqgDh8iwODz6OXIGKU8r5m4Y=
+github.com/olekukonko/ll v0.0.9 h1:Y+1YqDfVkqMWuEQMclsF9HUR5+a82+dxJuL1HHSRpxI=
+github.com/olekukonko/ll v0.0.9/go.mod h1:En+sEW0JNETl26+K8eZ6/W4UQ7CYSrrgg/EdIYT2H8g=
+github.com/olekukonko/tablewriter v1.1.0 h1:N0LHrshF4T39KvI96fn6GT8HEjXRXYNDrDjKFDB7RIY=
+github.com/olekukonko/tablewriter v1.1.0/go.mod h1:5c+EBPeSqvXnLLgkm9isDdzR3wjfBkHR9Nhfp3NWrzo=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/rivo/uniseg v0.2.0 h1:S1pD9weZBuJdFmowNwbpi7BJ8TNftyUImj/0WQi72jY=
+github.com/rivo/uniseg v0.2.0/go.mod h1:J6wj4VEh+S6ZtnVlnTBMWIodfgj8LQOQFoIToxlJtxc=
+github.com/rogpeppe/go-internal v1.13.1 h1:KvO1DLK/DRN07sQ1LQKScxyZJuNnedQ5/wKSR38lUII=
+github.com/rogpeppe/go-internal v1.13.1/go.mod h1:uMEvuHeurkdAXX61udpOXGD/AzZDWNMNyH2VO9fmH0o=
+github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
+github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
+go.opentelemetry.io/auto/sdk v1.1.0 h1:cH53jehLUN6UFLY71z+NDOiNJqDdPRaXzTel0sJySYA=
+go.opentelemetry.io/auto/sdk v1.1.0/go.mod h1:3wSPjt5PWp2RhlCcmmOial7AvC4DQqZb7a7wCow3W8A=
+go.opentelemetry.io/otel v1.38.0 h1:RkfdswUDRimDg0m2Az18RKOsnI8UDzppJAtj01/Ymk8=
+go.opentelemetry.io/otel v1.38.0/go.mod h1:zcmtmQ1+YmQM9wrNsTGV/q/uyusom3P8RxwExxkZhjM=
+go.opentelemetry.io/otel/metric v1.38.0 h1:Kl6lzIYGAh5M159u9NgiRkmoMKjvbsKtYRwgfrA6WpA=
+go.opentelemetry.io/otel/metric v1.38.0/go.mod h1:kB5n/QoRM8YwmUahxvI3bO34eVtQf2i4utNVLr9gEmI=
+go.opentelemetry.io/otel/sdk v1.38.0 h1:l48sr5YbNf2hpCUj/FoGhW9yDkl+Ma+LrVl8qaM5b+E=
+go.opentelemetry.io/otel/sdk v1.38.0/go.mod h1:ghmNdGlVemJI3+ZB5iDEuk4bWA3GkTpW+DOoZMYBVVg=
+go.opentelemetry.io/otel/sdk/metric v1.38.0 h1:aSH66iL0aZqo//xXzQLYozmWrXxyFkBJ6qT5wthqPoM=
+go.opentelemetry.io/otel/sdk/metric v1.38.0/go.mod h1:dg9PBnW9XdQ1Hd6ZnRz689CbtrUp0wMMs9iPcgT9EZA=
+go.opentelemetry.io/otel/trace v1.38.0 h1:Fxk5bKrDZJUH+AMyyIXGcFAPah0oRcT+LuNtJrmcNLE=
+go.opentelemetry.io/otel/trace v1.38.0/go.mod h1:j1P9ivuFsTceSWe1oY+EeW3sc+Pp42sO++GHkg4wwhs=
+go.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto=
+go.uber.org/goleak v1.3.0/go.mod h1:CoHD4mav9JJNrW/WLlf7HGZPjdw8EucARQHekz1X6bE=
+golang.org/x/net v0.40.0 h1:79Xs7wF06Gbdcg4kdCCIQArK11Z1hr5POQ6+fIYHNuY=
+golang.org/x/net v0.40.0/go.mod h1:y0hY0exeL2Pku80/zKK7tpntoX23cqL3Oa6njdgRtds=
+golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.35.0 h1:vz1N37gP5bs89s7He8XuIYXpyY0+QlsKmzipCbUtyxI=
+golang.org/x/sys v0.35.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k=
+golang.org/x/text v0.25.0 h1:qVyWApTSYLk/drJRO5mDlNYskwQznZmkpV2c8q9zls4=
+golang.org/x/text v0.25.0/go.mod h1:WEdwpYrmk1qmdHvhkSTNPm3app7v4rsT8F2UD6+VHIA=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

package/skills/goframe-v2/examples/httpserver/upload-file/main.go

@@ -0,0 +1,78 @@
+// Copyright GoFrame Author(https://goframe.org). All Rights Reserved.
+//
+// This Source Code Form is subject to the terms of the MIT License.
+// If a copy of the MIT was not distributed with this file,
+// You can obtain one at https://github.com/gogf/gf.
+
+// Package main demonstrates file upload handling in a HTTP server using GoFrame.
+// It showcases how to:
+// 1. Handle file uploads with proper validation
+// 2. Serve static files for the upload interface
+// 3. Process multipart/form-data requests
+// 4. Implement type-safe request/response handling
+package main
+
+import (
+	"context"
+
+	"github.com/gogf/gf/v2/errors/gerror"
+	"github.com/gogf/gf/v2/frame/g"
+	"github.com/gogf/gf/v2/net/ghttp"
+)
+
+// UploadReq defines the request structure for file upload.
+// It uses GoFrame's metadata to specify the endpoint and request requirements.
+type UploadReq struct {
+	g.Meta `path:"/upload" method:"POST" tags:"Upload" mime:"multipart/form-data" summary:"Upload File"`
+	File   *ghttp.UploadFile `p:"file" type:"file" dc:"File to upload" v:"required"`
+	Msg    string            `p:"msg" dc:"Optional message"`
+}
+
+// UploadRes defines the response structure for file upload.
+type UploadRes struct {
+	FileName string `json:"fileName" dc:"Name of the uploaded file"`
+	Message  string `json:"message,omitempty" dc:"Optional message if provided"`
+}
+
+// Upload is the controller structure for handling file uploads.
+type Upload struct{}
+
+// Upload handles the file upload request.
+// It validates the uploaded file and returns the file information.
+func (u Upload) Upload(ctx context.Context, req *UploadReq) (*UploadRes, error) {
+	if req.File == nil {
+		return nil, gerror.New("no file uploaded")
+	}
+
+	// Here you can add additional file processing logic
+	// For example, saving the file to a specific location:
+	// filename, err := req.File.Save("./uploads/")
+
+	return &UploadRes{
+		FileName: req.File.Filename,
+		Message:  req.Msg,
+	}, nil
+}
+
+// main initializes and starts the HTTP server with file upload capabilities.
+func main() {
+	s := g.Server()
+
+	// Configure static file serving for the upload interface
+	s.SetIndexFolder(true)
+	s.SetServerRoot("static")
+
+	// Configure API routes
+	s.Group("/", func(group *ghttp.RouterGroup) {
+		group.Middleware(ghttp.MiddlewareHandlerResponse)
+		group.Bind(Upload{})
+	})
+
+	// Configure server settings
+	s.SetClientMaxBodySize(600 * 1024 * 1024) // 600MB max file size
+	s.SetPort(8000)
+	s.SetAccessLogEnabled(true)
+
+	// Start the server
+	s.Run()
+}

package/skills/goframe-v2/examples/httpserver/upload-file/static/index.html

@@ -0,0 +1,151 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>GoFrame File Upload Demo</title>
+    <style>
+        body {
+            font-family: Arial, sans-serif;
+            max-width: 800px;
+            margin: 0 auto;
+            padding: 20px;
+            background-color: #f5f5f5;
+        }
+        .upload-container {
+            background-color: white;
+            padding: 20px;
+            border-radius: 8px;
+            box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+        }
+        .upload-form {
+            display: flex;
+            flex-direction: column;
+            gap: 15px;
+        }
+        .file-input {
+            padding: 10px;
+            border: 2px dashed #ccc;
+            border-radius: 4px;
+            cursor: pointer;
+        }
+        .submit-button {
+            padding: 10px 20px;
+            background-color: #4CAF50;
+            color: white;
+            border: none;
+            border-radius: 4px;
+            cursor: pointer;
+            font-size: 16px;
+        }
+        .submit-button:hover {
+            background-color: #45a049;
+        }
+        .message {
+            margin-top: 20px;
+            padding: 10px;
+            border-radius: 4px;
+            display: none;
+        }
+        .success {
+            background-color: #dff0d8;
+            color: #3c763d;
+            border: 1px solid #d6e9c6;
+        }
+        .error {
+            background-color: #f2dede;
+            color: #a94442;
+            border: 1px solid #ebccd1;
+        }
+        .progress-bar {
+            width: 100%;
+            height: 20px;
+            background-color: #f0f0f0;
+            border-radius: 10px;
+            overflow: hidden;
+            display: none;
+        }
+        .progress {
+            width: 0%;
+            height: 100%;
+            background-color: #4CAF50;
+            transition: width 0.3s ease;
+        }
+    </style>
+</head>
+<body>
+    <div class="upload-container">
+        <h1>File Upload Demo</h1>
+        <form class="upload-form" id="uploadForm">
+            <div>
+                <label for="file">Select File:</label>
+                <input type="file" id="file" name="file" class="file-input" required>
+            </div>
+            <div>
+                <label for="msg">Message:</label>
+                <input type="text" id="msg" name="msg" placeholder="Optional message">
+            </div>
+            <div class="progress-bar" id="progressBar">
+                <div class="progress" id="progress"></div>
+            </div>
+            <button type="submit" class="submit-button">Upload File</button>
+        </form>
+        <div id="message" class="message"></div>
+    </div>
+
+    <script>
+        document.getElementById('uploadForm').addEventListener('submit', async (e) => {
+            e.preventDefault();
+            
+            const formData = new FormData();
+            const fileInput = document.getElementById('file');
+            const msgInput = document.getElementById('msg');
+            const progressBar = document.getElementById('progressBar');
+            const progress = document.getElementById('progress');
+            const message = document.getElementById('message');
+            
+            if (fileInput.files.length === 0) {
+                showMessage('Please select a file', false);
+                return;
+            }
+            
+            formData.append('file', fileInput.files[0]);
+            formData.append('msg', msgInput.value);
+            
+            progressBar.style.display = 'block';
+            message.style.display = 'none';
+            
+            try {
+                const response = await fetch('/upload', {
+                    method: 'POST',
+                    body: formData,
+                    onUploadProgress: (progressEvent) => {
+                        const percentCompleted = Math.round((progressEvent.loaded * 100) / progressEvent.total);
+                        progress.style.width = percentCompleted + '%';
+                    }
+                });
+                
+                const result = await response.json();
+                
+                if (response.ok) {
+                    showMessage(`File "${result.fileName}" uploaded successfully!`, true);
+                } else {
+                    showMessage('Upload failed: ' + result.message, false);
+                }
+            } catch (error) {
+                showMessage('Upload failed: ' + error.message, false);
+            } finally {
+                progressBar.style.display = 'none';
+                progress.style.width = '0%';
+            }
+        });
+        
+        function showMessage(text, isSuccess) {
+            const message = document.getElementById('message');
+            message.textContent = text;
+            message.className = 'message ' + (isSuccess ? 'success' : 'error');
+            message.style.display = 'block';
+        }
+    </script>
+</body>
+</html>

package/skills/goframe-v2/examples/nosql/mongodb/README.MD

@@ -0,0 +1,101 @@
+---
+title: MongoDB
+slug: /examples/nosql/mongodb
+keywords: [nosql, mongodb, database, goframe]
+description: Demonstrates comprehensive MongoDB integration with GoFrame for document-based data storage and retrieval. This example showcases MongoDB connection setup and configuration with official Go driver, CRUD operations (Create, Read, Update, Delete) for documents, advanced querying with filters and projections, aggregation pipeline usage for data analysis, index creation and management for performance, transaction support for data consistency, and connection pooling configuration. Features include automatic connection management, error handling patterns, integration with GoFrame's ORM concepts where applicable, document marshaling/unmarshaling, pagination support, and production-ready database operations. Ideal for building applications requiring flexible schema design, document-oriented data models, complex aggregations, horizontal scalability, and NoSQL database integration in microservices architectures.
+hide_title: true
+sidebar_position: 2
+---
+
+# GoFrame MongoDB Example
+
+This example demonstrates how to use `MongoDB` with `GoFrame` framework.
+
+## Overview
+
+This example shows:
+1. How to configure `MongoDB` connection using `YAML` configuration
+2. How to create a `MongoDB` client
+3. Basic `MongoDB` operations (`INSERT`, `FIND`, `UPDATE`)
+4. How to use `BSON` for document operations
+
+## Requirements
+
+- `Go 1.15` or higher
+- `MongoDB` server
+- `GoFrame v2`
+
+## Configuration
+
+The `MongoDB` configuration is stored in `config.yaml`:
+
+```yaml
+mongo:
+  database: "user"
+  address: "mongodb://127.0.0.1:27017/test?retryWrites=true"
+```
+
+You can modify these settings according to your `MongoDB` server configuration.
+
+## Running MongoDB with Docker
+
+If you don't have `MongoDB` installed locally, you can quickly start a `MongoDB` instance using `Docker`:
+
+```bash
+# Run MongoDB container
+docker run --name mongo-test -p 27017:27017 -d mongo:latest
+
+# Verify the container is running
+docker ps
+
+# If you need to stop the container later
+docker stop mongo-test
+
+# If you need to remove the container
+docker rm mongo-test
+```
+
+For `MongoDB` with authentication:
+
+```bash
+# Run MongoDB with authentication
+docker run --name mongo-test -p 27017:27017 -e MONGO_INITDB_ROOT_USERNAME=admin -e MONGO_INITDB_ROOT_PASSWORD=password -d mongo:latest
+
+# Remember to update config.yaml accordingly:
+# mongo:
+#   database: "user"
+#   address: "mongodb://admin:password@127.0.0.1:27017/test?retryWrites=true"
+```
+
+## Running the Example
+
+1. Make sure your `MongoDB` server is running
+2. Update the `config.yaml` if needed
+3. Run the example:
+
+```bash
+go run main.go
+```
+
+## Code Structure
+
+- `main.go`: Contains the main logic and `MongoDB` client initialization
+- `config.yaml`: `MongoDB` configuration file
+
+## Features
+
+1. `MongoDB` client initialization with error handling
+2. Configuration management using `GoFrame`'s configuration system
+3. Basic `MongoDB` operations demonstration
+4. Proper error handling and logging
+5. Use of `BSON` tags for document mapping
+
+## Further Reading
+
+For more advanced `MongoDB` usage, please refer to the official `MongoDB` Go driver [github.com/mongodb/mongo-go-driver](https://github.com/mongodb/mongo-go-driver).
+
+## Notes
+
+- The example uses the official `MongoDB` Go driver
+- All operations are performed with context for proper cancellation and timeout handling
+- The code includes proper error handling and logging

package/skills/goframe-v2/examples/nosql/mongodb/README.ZH.MD

@@ -0,0 +1,91 @@
+---
+title: MongoDB
+slug: /examples/nosql/mongodb
+keywords: [nosql, mongodb, database, goframe]
+description: 演示在GoFrame中全面集成MongoDB用于基于文档的数据存储和检索。本示例展示了使用官方Go驱动的MongoDB连接设置和配置、文档的CRUD操作(创建、读取、更新、删除)、带有过滤器和投影的高级查询、用于数据分析的聚合管道使用、用于性能优化的索引创建和管理、用于数据一致性的事务支持、以及连接池配置。主要功能包括:自动连接管理、错误处理模式、在适用情况下与GoFrame的ORM概念集成、文档序列化/反序列化、分页支持、生产级数据库操作。非常适合构建需要灵活模式设计、面向文档的数据模型、复杂聚合、水平扩展性、以及在微服务架构中集成NoSQL数据库的应用程序。通过本示例可以学习如何在GoFrame中使用MongoDB、NoSQL数据库的最佳实践、以及构建灵活高性能的文档存储系统。
+hide_title: true
+sidebar_position: 2
+---
+
+# GoFrame MongoDB 示例
+
+此示例演示了如何在 `GoFrame` 框架中使用 `MongoDB`。
+
+## 概述
+
+本示例展示了：
+1. 如何使用 `YAML` 配置文件配置 `MongoDB` 连接
+2. 如何创建 `MongoDB` 客户端
+3. 基本的 `MongoDB` 操作（`INSERT`、`FIND`、`UPDATE`）
+4. 如何使用 `BSON` 进行文档操作
+
+## 环境要求
+
+- `Go 1.15` 或更高版本
+- `MongoDB` 服务器
+- `GoFrame v2`
+
+## 代码结构
+
+- `main.go`: 包含主要逻辑和 `MongoDB` 客户端初始化
+- `config.yaml`: `MongoDB` 配置文件
+
+
+## 配置说明
+
+`MongoDB` 配置存储在 `config.yaml` 文件中：
+
+```yaml
+mongo:
+  database: "user"
+  address: "mongodb://127.0.0.1:27017/test?retryWrites=true"
+```
+
+您可以根据自己的 `MongoDB` 服务器配置修改这些设置。
+
+## 使用 Docker 运行 MongoDB
+
+如果您本地没有安装 `MongoDB`，可以使用 `Docker` 快速启动一个 `MongoDB` 实例：
+
+```bash
+# 运行 MongoDB 容器
+docker run --name mongo-test -p 27017:27017 -d mongo:latest
+
+# 验证容器是否正在运行
+docker ps
+
+# 如果需要停止容器
+docker stop mongo-test
+
+# 如果需要删除容器
+docker rm mongo-test
+```
+
+如果需要带认证的 `MongoDB`：
+
+```bash
+# 运行带认证的 MongoDB
+docker run --name mongo-test -p 27017:27017 -e MONGO_INITDB_ROOT_USERNAME=admin -e MONGO_INITDB_ROOT_PASSWORD=password -d mongo:latest
+
+# 记得相应地更新 config.yaml：
+# mongo:
+#   database: "user"
+#   address: "mongodb://admin:password@127.0.0.1:27017/test?retryWrites=true"
+```
+
+## 运行示例
+
+1. 确保 `MongoDB` 服务器正在运行
+2. 根据需要更新 `config.yaml`
+3. 运行示例：
+
+```bash
+go run main.go
+```
+
+
+
+
+## 更多参考
+
+更多 `MongoDB` 的使用方法请参考官方 `MongoDB` Go 驱动 [github.com/mongodb/mongo-go-driver](https://github.com/mongodb/mongo-go-driver)。

package/skills/goframe-v2/examples/nosql/mongodb/config.yaml

@@ -0,0 +1,3 @@
+mongo:
+  database: "user"
+  address: "mongodb://127.0.0.1:27017/test?retryWrites=true"

package/skills/goframe-v2/examples/nosql/mongodb/go.mod

@@ -0,0 +1,47 @@
+module main
+
+go 1.23.0
+
+require (
+	github.com/gogf/gf/v2 v2.10.0
+	go.mongodb.org/mongo-driver v1.17.2
+)
+
+require (
+	github.com/BurntSushi/toml v1.5.0 // indirect
+	github.com/clbanning/mxj/v2 v2.7.0 // indirect
+	github.com/emirpasic/gods/v2 v2.0.0-alpha // indirect
+	github.com/fatih/color v1.18.0 // indirect
+	github.com/fsnotify/fsnotify v1.9.0 // indirect
+	github.com/go-logr/logr v1.4.3 // indirect
+	github.com/go-logr/stdr v1.2.2 // indirect
+	github.com/golang/snappy v0.0.4 // indirect
+	github.com/google/uuid v1.6.0 // indirect
+	github.com/gorilla/websocket v1.5.3 // indirect
+	github.com/grokify/html-strip-tags-go v0.1.0 // indirect
+	github.com/klauspost/compress v1.16.7 // indirect
+	github.com/magiconair/properties v1.8.10 // indirect
+	github.com/mattn/go-colorable v0.1.13 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/mattn/go-runewidth v0.0.16 // indirect
+	github.com/montanaflynn/stats v0.7.1 // indirect
+	github.com/olekukonko/errors v1.1.0 // indirect
+	github.com/olekukonko/ll v0.0.9 // indirect
+	github.com/olekukonko/tablewriter v1.1.0 // indirect
+	github.com/rivo/uniseg v0.2.0 // indirect
+	github.com/xdg-go/pbkdf2 v1.0.0 // indirect
+	github.com/xdg-go/scram v1.1.2 // indirect
+	github.com/xdg-go/stringprep v1.0.4 // indirect
+	github.com/youmark/pkcs8 v0.0.0-20240726163527-a2c0da244d78 // indirect
+	go.opentelemetry.io/auto/sdk v1.1.0 // indirect
+	go.opentelemetry.io/otel v1.38.0 // indirect
+	go.opentelemetry.io/otel/metric v1.38.0 // indirect
+	go.opentelemetry.io/otel/sdk v1.38.0 // indirect
+	go.opentelemetry.io/otel/trace v1.38.0 // indirect
+	golang.org/x/crypto v0.38.0 // indirect
+	golang.org/x/net v0.40.0 // indirect
+	golang.org/x/sync v0.14.0 // indirect
+	golang.org/x/sys v0.35.0 // indirect
+	golang.org/x/text v0.25.0 // indirect
+	gopkg.in/yaml.v3 v3.0.1 // indirect
+)