{"id":41857467,"url":"https://github.com/ssbunny/zebra","last_synced_at":"2026-01-25T11:04:13.498Z","repository":{"id":28615245,"uuid":"32133804","full_name":"ssbunny/zebra","owner":"ssbunny","description":"功能特性完整、易扩展、编码灵活自由的Golang Web框架","archived":false,"fork":false,"pushed_at":"2015-03-30T07:24:40.000Z","size":332,"stargazers_count":6,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-06-20T12:06:26.666Z","etag":null,"topics":["go","golang","golang-web","web","zebra"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ssbunny.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-03-13T06:15:09.000Z","updated_at":"2024-04-11T01:50:45.000Z","dependencies_parsed_at":"2022-09-12T20:15:45.094Z","dependency_job_id":null,"html_url":"https://github.com/ssbunny/zebra","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ssbunny/zebra","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ssbunny%2Fzebra","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ssbunny%2Fzebra/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ssbunny%2Fzebra/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ssbunny%2Fzebra/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ssbunny","download_url":"https://codeload.github.com/ssbunny/zebra/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ssbunny%2Fzebra/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28752393,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T10:25:12.305Z","status":"ssl_error","status_checked_at":"2026-01-25T10:25:11.933Z","response_time":113,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["go","golang","golang-web","web","zebra"],"created_at":"2026-01-25T11:04:12.831Z","updated_at":"2026-01-25T11:04:13.491Z","avatar_url":"https://github.com/ssbunny.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zebra - 一个黑白分明的 Go Web 框架\n\n![zebra](logo.png)\n\nzebra 是一个追求简单实用，但同时功能特性完整、易扩展、编码灵活自由的 Golang Web 框架。\n它不依赖任何第三方包。\n\n* [新手入门]()\n* [用户指南](wiki/用户指南)\n* [使用手册]()\n\n\n\n## 如何使用\n\n使用 zebra 只需要创建一个 zebra 服务并启动它：\n\n``````go\nz := zebra.New()\nz.Run()\n``````\n\nzebra默认在 `3000` 端口运行，你也可以通过 `z.RunOnAddr(\":8888\")` 方法指定端口。另外，\n还可以通过`http.Server`来配置完整的服务信息，以便让zebra按照你自定义的方式运行：\n\n``````go\ns := \u0026http.Server{\n    Addr:           \":8080\",\n    ReadTimeout:    10 * time.Second,\n    WriteTimeout:   10 * time.Second,\n    MaxHeaderBytes: 1 \u003c\u003c 20,\n}\nz := zebra.NewWithServer(s)\nz.Run()\n``````\n\n\n\n## 路由\nzebra的路由是满足 RESTful 规则的路由，但需要注意的是，它并不支持完整的HTTP Method,\n我们只保留了一些常用的方法，如下：\n\n    \"GET\"\n    \"POST\"\n    \"PUT\"\n    \"OPTIONS\"\n    \"DELETE\"\n    \"HEAD\"\n\n我们相信这些方法足够您实现一个完整的 RESTful Web 服务。但是如果它们真的不足以满足您的需求，\n不要担心，zebra的路由中间件非常容易扩展。\n\n### 创建 Router\n使用 `zebra.NewRouter()` 方法即可创建一个Router.\n``````go\nr := zebra.NewRouter()\nr.Get(\"/foo\", func(c *zebra.Captain) {\n    // do some thing..\n})\napp := zebra.New()\napp.Use(r)\napp.Run()\n``````\n\n### 路由规则\nzebra的路由规则非常简单，使用它时你只需要记住一个能满足 80% 场景的规则 `:path`\n即可，例如我们为用户信息创建如下Router：\n\n``````go\n// http GET:  localhost:8888/user/zhangsan\nr.Get(\"/user/:name\", func(c *zebra.Captain) {\n    // 使用 c.Path(\"name\") 得到请求中的路径参数 'zhangsan'\n})\n``````\n\n我们在实践中发现，这种方式能解决绝大多数路由规则需求，但并不是万能的。\n你总会遇到一些特殊的匹配规则，此时，只需要编写自己的正则即可。\nzebra路由直接支持正则表达式，只需要将它放在一对花括号中：\n\n``````go\n// http GET:  localhost:8888/bar/badman123\nr.Get(\"/bar/:userName{badman[\\\\d]+}\", func(c *Captain) {\n    // c.Path(\"userName\")  ---\u003e  badman123\n})\n// 请求 localhost:8888/bar/goodboy1314 则不会被匹配\n``````\n\n\n\n## 日志\n\n创建日志模块并注册，即可记录 zebra 的访问日志：\n\n``````go\nlogger := NewLogger()\napp.Use(r)\n``````\n\nzebra 提供两种内置的日志格式：`common` 和 `combined`. 默认使用 `combined` 格式，它会记录类似\napache http combined 格式的日志。\n\n使用 `SetFormat(string)` 方法设置日志格式，如 `logger.SetFormat(\"common\")`。\n也可以使用自定义格式，如：\n\n``````go\nlogger := zebra.NewLogger()\nlogger.SetFormat(\"[:date] :method :url HTTP/:http-version (:response-time)\")\n``````\n\n\n\n\n## favicon\n\n## 静态服务\n\n## 如何编写自己的中间件\n\n## 整合其它应用\n\nzebra灵活的功能特性，允许你轻松整合 `http.ServeMux` 甚至其它第三方应用，如 `martini` .\n\n``````go\nmux := http.NewServeMux()\nmux.HandleFunc(\"/foo\", func(w http.ResponseWriter, r *http.Request) {\n    w.Write([]byte(\"hello zebra\"))\n})\n\nz := zebra.New()\nz.SetName(\"Zebra\")\nz.Use(mux)\nz.Run()\n``````\n\n另外，一个已完成的zebra应用，也可以被轻松地整合到一个全新的zebra应用，构成它的一部分。\n\n``````go\nsubApp := zebra.New()\nsubApp.SetName(\"bar\")\n// ...\n\napp := zebra.New()\napp.Use(subApp)\napp.Run()\n``````\n\n\n\n## 联系我们\n\n有问题可以直接创建一个issue\n\nPS: zebra目前处于开发阶段，欢迎有同样想法的朋友加入。","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fssbunny%2Fzebra","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fssbunny%2Fzebra","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fssbunny%2Fzebra/lists"}