2024-01-16 分類: 網站建設
最新HTTP/2標準已經發布,是基于谷歌QUIC的技術升級而成。雖然標準已經發布,但是目前還鮮有應用支持,那么有沒有方法進行技術嘗鮮呢?答案是肯定的。本文蟲蟲給大家介紹一個Golang Web服務器應用Algernon,作為一個單文件的Golang應用內置了HTTP/2,Lua,Markdown,Pongo2,HyperApp,Amber,Sass(SCSS),GCSS,JSX,BoltDB的功能,支持 Redis,PostgreSQL,MariaDB / MySQL數據庫。支持限速,插件,用戶和權限等各種功能。所有這些都包含在一個自包含可執行文件中,麻雀雖小五臟俱全。
技術架構使用Golang開發,后端數據庫可以使用Bolt(內置),MySQL,PostgreSQL或Redis(推薦)。對各種功能支持總共使用了下面的類庫:
permissions2用于處理用戶和權限;gopher-lua用于解釋和運行Lua;http2用于服務HTTP/2,QUIC用于服務QUIC;blackfriday用于Markdown渲染;amber用于Amber模板;Pongo2用于Pongo2模板;Sass(SCSS)和GCSS用于CSS預處理;logrus用于日志記錄;goja-babel用于從JSX轉換為JavaScript;tollbooth用于速率限制;pie用于插件支持;graceful用于優雅關閉。
設計思想該項目源于用Markdown,Pongo2,Amber,HTML或JSX(+ React)等編寫應用,并用CSS樣式支持和設計。數據使用Lua腳本與Redis,BoltDB,PostgreSQL或MariaDB/MySQL鏈接操作。
Pongo2,Sass和Lua也是很好的一個選擇,而且Pongo2比Amber更靈活。
Bolt是一個純粹的key/value存儲,使用Golang編寫。Bolt無需預先安裝設置數據庫,內置在Algernon中使用。也支持廣泛使用的數據庫,比如MariaDB/MySQL和PostgreSQL。
Algernon以下文件進行特殊渲染和解析以下文件(后綴),按優先順序排列:
index.lua是Lua代碼,動態lua腳本處理。
index.html HTML默認頁面。
index.md 渲染為HTML下的Markdown代碼。
index.txt 純文本文件。
index.pongo2,index.po2或index.tmpl渲染為HTML的Pongo2代碼。
index.amber渲染為HTML的Amber代碼。
index.hyper.js或index.hyper.jsx渲染為HTML的JSX + HyperApp代碼
data.lua是Lua代碼,其中函數和變量可用于同一目錄中的Pongo2、Amber和Markdown頁面。
如果將單個Lua腳本作為命令行參數提供,用于獨立服務器。它可用于設置處理程序或為特定URL前綴提供文件和目錄。
style.gcss是GCSS代碼,支持對同目錄下的Pongo2,Amber和Markdown頁面的樣式。
總之,Algernon支持對以下文件擴展名的處理??:
Markdown:.md(渲染為HTML)
Pongo2:.po2,.pongo2或.tpl(渲染為任何文本,通常為HTML)
琥珀色:.amber(渲染為HTML)
Sass:.scss(渲染為CSS)
GCSS:.gcss(渲染為CSS)
JSX:.jsx(渲染為JavaScript / ECMAScript)
Lua:.lua(提供自己的輸出和內容類型的腳本)
HyperApp:.hyper.js或.hyper.jsx(渲染為HTML)
根據擴展名為其他文件指定mimetype。
沒有索引文件的目錄顯示為目錄列表。
盡可能使用UTF-8。
可以通過命令行或lua腳本配置服務器,但是配置是非必須的,默認無需配置既可以使用。
技術特點支持HTTP,HTTP/2,默認啟動HTTPS(HTTP/2需要瀏覽器支持)。
支持Lua動態程序,可以使用Lua腳本處理程序。
Algernon可執行文件為本機靜態編譯編,速度相當快。
適用于Linux,OS X和64位Windows。
Lua解釋器被編譯為可執行文件。
支持熱部署自動刷新功能,實時編輯/實時預覽。
自包含的Algernon應用程序可以壓縮到存檔(以.zip或.alg結尾),支持子啟動時加載。
內置支持Markdown,Pongo2,Amber,Sass(SCSS),GCSS和JSX。
默認情況下,使用Redis作為數據庫后端,如果沒有可用的Redis服務器,Algernon將使用內置的Bolt數據庫。
可以對Markdown渲染的HTML頁面指定以MultiMarkdown語法的標題:
title: Title內容。
后臺無需要文件轉換器(如SASS)即可進行文件轉化。
如果設置了autorefresh,源文件時自動刷新頁面。
交互式REPL。
如果Markdown文件名作為第一個參數,則它將在端口3000上提供預覽,無需任何數據庫。方便在本地查看README.md文件。
完全多線程。將使用所有可用的CPU。
支持通過tollbooth進行速率限制。
Lua REPL提供了幫助命令,可快速瀏覽可用的Lua功能。
可以加載用任何語言編寫的插件。插件必須提供Lua.Code和Lua.Help函數,并通過stderr + stdin來交互JSON-RPC。
內置線程安全文件緩存,具有多種可用緩存模式(例如,僅用于緩存圖像)。
可以讀取并保存到JSON文檔。支持簡單的JSON路徑表達式(如簡單版本的XPath,但對于JSON)。
支持緩存壓縮,可以將緩存中存儲的文件直接從緩存發送到客戶端,無需解壓縮。
對大于4096B的文件發送到客戶端的文件默認使用gzip壓縮。
使用PostgreSQL作為后端數據庫時候,默認使用HSTORE鍵/值類型(PostgreSQL 9.1或更高版本)。
沒有外部依賴,純Golang程序。
需要Go 1.12或更高版本。另外用于QUIC支持的包不支持使用gccgo(GCC)構建。
安裝OS X蘋果OS X系統可以使用包管理器直接安裝:
brew install algernon
如果沒有安裝Homebrew包管理器,請先安裝。
Arch Linux可以使用AUR源安裝:
pacman -S algernon
二進制包其他系統請下載對應二進制包即可使用。
源碼安裝從源碼編譯安裝,適用于任何系統。用get命令從官方主分支下載最新源碼
get -u github/xyproto/algernon
使用該方法安裝,需要先設置GOPATH, 并將$GOPATH/bin添加到執行PATH中
export GOPATH =~/go
export PATH = $PATH:$GOPATH/bin
也可以先git clone到本地然后編譯安裝
Golang 1.12版本
早期Golang版本
docker容器Algernon基本使用運行Algernon:以開發者模式運行algernon -e
該命令啟用調試模式,以內置的Bolt數據庫,以HTTP形式啟動,并對除了以下類型的其他文件啟用緩存,這些類型包括Pongo2,Amber,Lua,Sass,GCSS,Markdown和JSX。
新建一個簡單的hello lua文件index.lua:
瀏覽器訪問,結果如下:
自定義Algernon應用程序創建應用目錄:
mkdir mypage && cd mypage
創建名為index.lua的文件,其中包含以下內容和上面一樣。
啟動:
algernon --httponly --autorefresh .
啟動增加參數autorefresh,使得文件編輯后可以熱加載實時生效。可以試著編輯下index.lua并刷新瀏覽器以查看新結果。
注意—autorefresh對Markdown,Pongo2和Amber頁面也生效,比如我新建一個chongchong.md頁面:
然后瀏覽器訪問:
HTTP/2 和HTTPS支持應用利用openssl創建創建自簽名證書,僅用于測試:
openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 3000 -nodes
結果中,按照提示中按Return鍵,在Common Name時候輸入任意名稱,我們輸入的是CC,就會在本目錄生成cert.pem和key.pem兩個證書文件
啟動
algernon .
然后通過瀏覽器以https訪問:
https://localhost:3000
由于使用子簽名證書,沒有添加根域證書,需要在瀏覽器添加信息才能訪問。
注意https頭信息,確實是HTTP/2。
Lua支持基本的Lua功能//返回服務器的版本字符串。
version() -> string
//睡眠給定的秒數(可以是浮點數)。
sleep(number)
//將給定的字符串記錄為信息。采用可變數量的字符串。
log(...)
//將給定的字符串記錄為警告。采用可變數量的字符串。
warn(...)
//將給定的字符串記錄為錯誤。采用可變數量的字符串。
err(...)
//返回1970年的納秒數(Unix時間)
unixnano() -> number
//將Markdown轉換為HTML
markdown(string) -> string
//返回運行REPL或腳本的目錄。如果給出了文件名(可選),則返回腳本運行的路徑,使用路徑分隔符和給定的文件名連接。
scriptdir([string]) -> string
//返回運行服務器的目錄。如果給出了文件名(可選),則返回服務器運行的路徑,使用路徑分隔符和給定的文件名連接。
serverdir([string]) -> string
Lua插件//在給定可執行文件路徑的情況下加載插件。成功時返回true。如果在Lua提示符上調用,將返回插件幫助文本。
Plugin(string)
//給定一個插件路徑,返回插件中Lua.Code函數返回的Lua代碼。可能會返回一個空字符串。
PluginCode(string) -> string//獲取插件路徑,函數名稱和參數。如果函數調用失敗,則返回空字符串;如果成功,則返回結果為JSON字符串。
CallPlugin(string, string, ...) -> string
Lua代碼庫函數這些函數可以與插件函數結合使用,用于存儲加載serverconf.lua時插件返回的Lua代碼,然后在處理請求時檢索Lua代碼。
//創建或使用代碼庫對象。 (可選)將數據結構名稱作為第一個參數。
CodeLib([string]) -> userdata
//給定命名空間和Lua代碼,將給定代碼添加到命名空間。成功時返回true。
codelib:add(string, string) -> bool
//給定命名空間和Lua代碼,將給定代碼設置為命名空間中的唯一代碼。成功時返回true。
codelib:set(string, string) -> bool
//給定命名空間,返回Lua代碼或空字符串。
codelib:get(string) -> string
//將給定命名空間中的(eval)代碼導入當前的Lua狀態。成功時返回true。
codelib:import(string) -> bool
//完全清除代碼庫。成功時返回true。
codelib:clear() -> bool
Lua文件上傳函數//創建文件上傳對象。采用表單ID(來自POST請求)作為第一個參數。將可選的大上載大小(以MiB為單位)作為第二個參數。
//失敗時返回nil和錯誤字符串,成功時返回userdata和空字符串。
UploadedFile(string[, number]) -> userdata, string
//返回客戶端指定的上傳文件名
uploadedfile:filename() -> string
//返回已接收數據的大小
uploadedfile:size() -> number
Lua處理請求函數//設置頁面的Content-Type。
content(string)
//返回請求的HTTP方法(GET,POST等)。
method() -> string
//將文本輸出到瀏覽器/客戶端。采用可變數量的字符串。
print(...)
//返回請求的URL路徑。
urlpath() -> string
//返回請求中的HTTP標頭,給定鍵或空字符串。
header(string) -> string
//在給定鍵和值的情況下設置HTTP標頭。
setheader(string, string)
更多函數支持請參考官方文檔,此處略。
Markdown支持Algernon實現對Markdown的快速瀏覽,實現在線webMarkdown查看器。-m標志用來啟動:
algernon -m README.md在瀏覽器中查看README.md。
除了常規的Markdown語法之外,Algernon還支持在Markdown文件的頂部設置頁眉標題和語法高亮樣式,如下所示:
該代碼將使用highlight.js突出顯示代碼,并提供多種樣式。
replace_with_theme后面的字符串將用于替換當前主題字符串與給定字符串。這使得可以為一個主題使用一個圖像(如logo_default_theme.png)。主題可以是light,dark,redbox,bw,github,wing,material,neon,default,werc或CSS文件的路徑。或者同一目錄下的style.gcss文件自定義的樣式。
范例和截圖官方提供了大量的范例可以供使用,可以在官方倉下載samplepack.zip安裝包,解壓到web目錄更目錄然后通過瀏覽器就可以訪問。
bootstrap小應用hyperapp計數這是在啟用調試模式時處理Lua腳本中的錯誤的方法。
three.jsAlgernon Charles Swinburne的一首詩,背景中有三個旋轉的圓環。使用CSS3高斯模糊,使用three.js作為3D圖形。
prettify代碼美化美化樣本的屏幕截圖,由單個Lua腳本提供。
todo小程序使用Alact和Algernon交互使用
tiles圖片拼圖小游戲非常感謝您讀完創新互聯的這篇文章:"Golang開發的全功能單文件Web服務器",僅為提供更多信息供用戶參考使用或為學習交流的方便。我們公司提供:網站建設、網站制作、官網建設、SEO優化、小程序制作等服務,歡迎聯系我們提供您的需求。
標題名稱:Golang開發的全功能單文件Web服務器
當前路徑:http://m.newbst.com/news43/313893.html
成都網站建設公司_創新互聯,為您提供網站改版、ChatGPT、建站公司、網站維護、網站內鏈、面包屑導航
聲明:本網站發布的內容(圖片、視頻和文字)以用戶投稿、用戶轉載內容為主,如果涉及侵權請盡快告知,我們將會在第一時間刪除。文章觀點不代表本網站立場,如需處理請聯系客服。電話:028-86922220;郵箱:631063699@qq.com。內容未經允許不得轉載,或轉載時需注明來源: 創新互聯
猜你還喜歡下面的內容