SCGI（簡單通用網關接口）

協定

客戶端通過一個可傳輸8比特位元組的可靠的流協定(a reliable stream protocol)連線到一個SCGI伺服器. 客戶端以傳送一個請求來開始. 請求的格式參看第3節. 當SCGI伺服器看到請求的結束時, 他發回一個回響,然後關閉連線. 回響的格式不在此協定里規定.

一個請求含有一定數目的頭和體. 頭的格式是:

headers ::= header*
headers ::= name NUL value NUL
name ::= notnull+
value ::= notnull*
notnull ::= <01> | <02> | <03> | ... | <ff>
NUL = <00>

在請求頭中,是不允許有重複的名字的. 第1個頭的名字必須是”CONTENT_LENGTH”,它的值是,一個非空的ASCII數字序列,以10進制來表示請求體的長度. “CONTENT_LENGTH” 必須總是存在的,即使它的值為0

並且還必須總有一個叫”SCGI”的頭,它的值為”1″. 為了促進從CGI的轉換, 標準的CGI環境變數也應該作為

SCGI頭提供.

請求頭以網路字元串(netstring)編碼後傳送. 網路字元串編碼在第4節中解釋. 請求體在請求頭之後傳送,它的長度有請求體的”CONTENT_LENGTH” 頭的值指定.

任何8比特位元組的串, 都可以以 [len]“:”[string]“,” 的格式編碼. 這裡, [string] 是一個字元串, [len]是

[string]的長度,以十進制表示為ASCII形式的數字. ASCII數字是 <30> 表示 0, <31>表示1, 以此類推,<39>表示 9. 在[len]前面不能有額外的0: <30>開始的[len] 表示 [string]是空的

舉個例子:

字元串”hello world!” 編碼為

<31 32 3a 68 65 6c 6c 6f 20 77 6f 72 6c 64 21 2c>

也就是

“12:hello world!,”