mORMotBP

Mormotbp

樣板http服務器用於概要的摩爾特框架

該項目將HTML5樣板資產和設置嵌入了Synopse Mormot框架：

• html5boilerplate.com
  HTML5樣板是一種專業的前端模板，用於快速，健壯和適應性的Web應用程序或站點。它是10年以上迭代發展和社區知識的產物。它不會強加特定的開發理念或框架，因此您可以自由地按照所需的方式來構建代碼。通過100秒的開發人員的綜合知識和精力來啟動您的項目，所有這些都在一個小包裝中。
• Synopse.info
  Synopse Mormot是Delphi和FPC的開源客戶端服務器ORM SOA MVC框架，針對服務器的Windows/Linux和任何用於客戶端的平台（包括移動設備或AJAX）。

快速開始

1. 從GitHub存儲庫下載最新的MormotBP版本
2. 將mORMotBP目錄添加到您的IDE庫路徑
3. 添加接下來的兩個預構建事件以創建資源文件Assets.res用所有H5BP資源嵌入：

• "..Toolsassetslz" "$(PROJECTDIR)Assets" "$(PROJECTDIR)Assets.tmp"
• "..Toolsresedit" -D "$(PROJECTDIR)Assets.res" rcdata ASSETS "$(PROJECTDIR)Assets.tmp"

將"..Tools"替換為MormorBP相對或完整目錄位置。

4. 用TBoilerplateHTTPServer替換TSQLHttpServer實例創建
5. 通過調用YourHTTPServerInstance.LoadFromResource('Assets');

特徵

• 與HTML5樣板完全對齊HTTP配置，具有超過50個以上的選項和屬性。
• 專為Delphi 6到Delphi 10.4.1悉尼， Kylix 3 （超過Crosskylix）和FPC設計，針對窗口或Linux ， 32位或64位體系結構。
• 將所有靜態資產嵌入應用程序文件中，作為高度壓縮的Synlz存檔（請參閱assetslz和resedit工具）。這允許構建單個文件分佈。
• 通過返回Mem-Cached存儲庫中的所有靜態資產來保存雲託管磁盤IO操作。
• 不要花費CPU週期來壓縮資產，您所有的資產都將由assetslz工具預壓縮。
• 支持GZIP級別9最大壓縮。
• 支持ZOPFLI壓縮（與最大GZIP壓縮相比，可節省多達5-15％的流量和交付時間）。
• 根據RFC 7932支持Brotli壓縮（與ZOPFLI壓縮相比，另外15％-25％的流量和輸送時間）。
• 支持動態Brotli壓縮（在64位系統上節省約25％的CPU使用，少約10％的交貨時間和流量利用率）。
• 能夠將壓縮文件委派給低級HTTP.sys高性能庫（請參閱.StaticRoot屬性）並免費使用服務器線程，以獲取更多有趣的工作。
• 支持ETag/Last-Modified或更易於用戶友好的Last-Modified/If-Modified-Since緩存策略。
• 服務器端Expires或Cache-Control: max-age緩存策略。
• 不同的緩存破壞策略（請參閱bpoEnableCacheBusting和bpoEnableCacheBustingBeforeExt選項）。
• 修復HTTP標題中眾所周知的操縱接受值。
• 塊訪問可以暴露敏感信息的文件（請參閱bpoDelegateHidden和bpoDelegateBlocked選項）。
• 在HTML5樣板設置之後，應用許多HTTP標頭校正。
• 支持內容安全策略級別2 /級別3（有關詳細信息，請參見CSP.pas單元）。
• 支持IANA，Apache和Mozilla的1490 MIME類型文件擴展。
• 使用內容/文件傳輸和重定向支持外部可計算資產和URL請求（請參見.OnGetAsset事件）
• 您可以安全替換tsqlhttpserver的任何地方

TBoilerplateHTTPServer = class (TSQLHttpServer)

拉撒路免費帕斯卡支持

在Lazarus IDE下構建或更新Assets.res文件使用下一個菜單（打開項目文件時）：

Run / Build File

此菜單命令調用pre-build.sh或pre-build.bat腳本，該腳本使用assetslz32 / assetslz64和resedit32 / resedit64工具在Linux / Windows環境下壓縮和嵌入資產。

將下一個FPC Lazarus IDE指令添加到任何項目文件中，以重建資源文件：

 { $IFDEF LINUX }
  { %BuildCommand pre-build.sh $ProjPath() }
{ $ENDIF }
{ $IFDEF MSWINDOWS }
  { %BuildCommand pre-build.bat "$ProjPath()" }
{ $ENDIF } 

Delphi 2006年6月7日支持

非常感謝Kiran Kurapaty的Delphi 5和Delphi 7的BuildOptions套件。根據他的代碼，創建了Delphi 5/6/7/2005/2006的修改後的IDE套件，以啟用對Delphi IDE版本的所有Delphi IDE版本的構建活動，在Delphi 2007年之前引入了第一次構建活動。

使用組件 /安裝軟件包 /添加IDE菜單以安裝構建事件IDE擴展：

• ToolsBuildEventsBuildEventsD5.bpl for delphi 5
• ToolsBuildEventsBuildEventsD6.bpl for delphi 6
• ToolsBuildEventsBuildEventsD7.bpl for delphi 7
• ToolsBuildEventsBuildEventsD2005.bpl for delphi 2005
• ToolsBuildEventsBuildEventsD2006.bpl for delphi 2006

借助此構建事件和特殊的.bat文件，您可以模擬DEBUG和RELEASE配置。有關詳細信息，請參閱“構建事件”。

推薦的DEBUG配置

由於Zopfli算法的壓縮性質慢80倍，在開發和調試過程中使用它是不合理的。因此，對於所有調試配置，您可以使用Assetslz工具的-GZ1 -B1選項使用快速和光級壓縮：

• "..Toolsassetslz" -GZ1 -B1 "$(PROJECTDIR)Assets" "$(PROJECTDIR)Assets.tmp"
• "..Toolsresedit" -D "$(PROJECTDIR)Assets.res" rcdata ASSETS "$(PROJECTDIR)Assets.tmp"

推薦的RELEASE配置

對於發布配置，建議打開bpoForceHTTPS ，並將.StrictSSL屬性設置為strictSSLOn甚至strictSSLIncludeSubDomains 。設置.ContentSecurityPolicy屬性並使用安全標頭服務驗證它（有關詳細信息，請參見CSP.pas單元）。

禁用生產Server HTTP標頭

出於安全原因，您可以通過生產中的HTTP標頭完全禁用Server和X-Powered-By 。為此，添加NOXPOWEREDNAME定義為項目 /選項 /條件定義並重建所有內容。

如果您在Windows Server上使用HTTP.sys API添加或修改下一個註冊表密鑰以禁用Server HTTP HETER嵌入（需要管理權）：

部分： SYSTEMCurrentControlSetServicesHTTPParameters

鍵： DisableServerHeader: DWORD = 2

啟用動態brotli壓縮

不幸的默認mormot HTTP服務器始終使用第一個註冊的壓縮，以防多個壓縮選項可用。為了啟用Brotli的支持（HTML，JSON，XML等），請執行下一個內容：

關閉mORMotHttpServer.pas單元中的默認deflate壓縮（第76行）：

前

 { $define COMPRESSDEFLATE }

後

 {.$define COMPRESSDEFLATE}

然後在Brotli, GZip訂單：

 uses
  SynZip,
  Brotli;
...

    HttpServer.RegisterCompress(CompressBrotli);
    HttpServer.RegisterCompress(CompressGZip);

外部，動態，可計算資產的使用和自定義重定向

您可以提供自己的可計算資產和重定向。這對：

• 動態計算內容
• 返回任何請求的自定義重定向，它為您打開了項目遷移的能力，A/B測試，合成/棄用鏈接支持等。
• par症稀有的較新的動態含量，並用GZIP，Zopfli或brotli壓縮它。
• 將任何存儲的文件傳輸到客戶端。
• 自定義動態/404.html內容服務。

使用BoilerplateHTTPServer.OnGetAsset事件處理程序，並確保使用多線程支持處理可修改的資源。所有外部資產都支持ETag ，基於提供的Timestamp屬性的Last-Modified緩存策略，並且可以靜態上傳到存儲（例如，將內容Tranfer委託給低級HTTP API）。可以使用相同的方法返回特定URL路徑的自定義重定向。

先進的TAssets用法

您可以將任何目錄或文件嵌入到單個項目可執行文件中。這使您能夠在生產環境上分發，擴展並僅運行一個文件。從資源加載並在生產開始時部署任何資產。 TAssets還會檢查文件是否修改時間戳和大小更改，然後再保存以優化磁盤IO操作。

例如，您可以將所有靜態資產壓縮並包裝到Assets.res中。 RES，另外將小鬍子視圖模板包裝到單獨的Views.res中。

• "..Toolsassetslz" "$(PROJECTDIR)Assets" "$(PROJECTDIR)Assets.tmp"
• "..Toolsresedit" -D "$(PROJECTDIR)Assets.res" rcdata ASSETS "$(PROJECTDIR)Assets.tmp"
• "..Toolsassetslz" -E "$(PROJECTDIR)Views" "$(PROJECTDIR)Views.tmp"
• "..Toolsresedit" -D "$(PROJECTDIR)Views.res" rcdata VIEWS "$(PROJECTDIR)Views.tmp"

視圖的-E選項意味著跳過任何壓縮，因為我們不需要壓縮鬍子視圖。現在，您可以將兩個資源文件嵌入可執行文件中。將下一行添加到您的項目文件附近{$R *.res}附近或將兩個文件添加到項目：

 { $R Assets.res }
{ $R Views.res }

然後，在生產中，您可以從這樣的可執行文件中提取視圖：

 procedure SaveViews ;
var
  Assets: TAssets;
begin
  Assets.Init;
  Assets.LoadFromResource( ' Views ' );
  Assets.SaveAllIdentities( ' Views ' );
end ;

自定義選項

使用RegisterCustomOptions方法，您可以為不同的HTTP URL路徑調整不同的選項。例如，您可以為您的API JSON呼叫或一些類似的特殊頁面禁用緩存使用量：

  HTTPServer.RegisterCustomOptions(
    [ ' /api/json ' , ' /login ' , ' /settings* ' ],
    HTTPServer.Options - [bpoSetCachePublic] + [bpoSetCachePrivate,
      bpoSetCacheNoCache, bpoSetCacheNoStore, bpoSetCacheMustRevalidate]);

測試套件

TBoilerplateHTTPServer已全面測試，覆蓋了Mormot Test Suite框架。使用行為驅動的開發（BDD）方案而不是經典的TDD方法。有關詳細信息，請參見TestsBoilerplateTests.pas 。

更改日誌

該項目遵守語義版本。每個版本以及遷移說明都記錄在GitHub版本頁面上。

執照

該代碼可根據MIT許可證獲得。

聯繫人

隨時通過@gmail.com與我聯繫： eugene.ilyin