聲明：所有資料都來源于網(wǎng)絡(luò)上。
字典：
鍵值對(duì) key-value
示例： my_name: jackson
提示：以#開頭的內(nèi)容表示注釋，以":"為結(jié)束符的字符串，代表了一個(gè)key鍵名，":"后面則是鍵值。“：”和value鍵值之間至少有一個(gè)空格。
YAML 入門
QeePHP 為了方便開發(fā)者，大量使用了 YAML 格式的文件來存儲(chǔ)配置信息。因此掌握閱讀和書寫 YAML 格式文檔的基本知識(shí)是很有必要的。
YAML 格式本身具有非常強(qiáng)大的表達(dá)能力，常用的有下面幾種：
（1）名值對(duì)，例如 key => value，這和 PHP 中以字符串做鍵名的數(shù)組一樣；
（2）列表，例如 value1, value2，這和 PHP 中以數(shù)字做鍵名的數(shù)組一樣；
（3）多行文本。
1、 名值對(duì)
（1）最簡(jiǎn)單的名值對(duì)：
# 這是一行注釋
my_name: rockwell # 這也是注釋 以 # 開頭的內(nèi)容則是注釋。
以“:”為結(jié)束符的字符串，代表了一個(gè)鍵名，“:”后面則是鍵值。“:”和鍵值之間必須有至少一個(gè)空格。
因此，上述內(nèi)容 my_name 是鍵名，rockwell 是鍵值
（2）嵌套的名值對(duì)：
#### 首頁(yè)顯示設(shè)置 homepage:
# 首頁(yè)內(nèi)容緩存時(shí)間（秒） cached_lifetime: 300
# 首頁(yè)上顯示多少條最新主題文章 topics_num: 2
# 首頁(yè)上顯示多少條最新社區(qū)活動(dòng) activities_num: 3
cached_lifetime 等鍵是 homepage 鍵的次級(jí)，所以 cached_lifetime 前面有兩個(gè)空格作為縮進(jìn)。使用兩個(gè)空格作為一級(jí)縮進(jìn)是 YAML 的約定，不能使用制表符（Tab）來代替，務(wù)必注意這一點(diǎn)。
在書寫名值對(duì)時(shí)，如果鍵名或鍵值包含非英文字母和數(shù)字，應(yīng)該用引號(hào)括起來： '標(biāo)題': '這是我的第一本雜志'
這里我們使用了單引號(hào)。而雙引號(hào)和單引號(hào)的區(qū)別： '鍵名1': '文字\n文字' '鍵名2': "文字\n文字"
使用雙引號(hào)括起來的字符串中的 \n 符號(hào)會(huì)被解析為換行符，而單引號(hào)中的 \n 符號(hào)則仍然視為兩個(gè)普通字符。
2、 列表
（1）簡(jiǎn)單的列表：
- value1
- value2
- value3
另一種寫法：
- [value1, value2, value3]
注意第二種寫法前面的“-”必不可少，并且要跟隨至少一個(gè)空格。
（2）名值對(duì)和列表的混用：
名值對(duì)和列表混用是很常見的寫法，參考： # 后臺(tái)管理菜單標(biāo)簽 admin_tabs: '首頁(yè)': -
title: '主題文章'
udi: 'admin::topics/index' -
title: '社區(qū)活動(dòng)'
udi: 'admin::activities/index'
'項(xiàng)目': -
title: '項(xiàng)目管理'
udi: 'admin::projects/index'
'應(yīng)用': -
title: '應(yīng)用展示管理' udi: 'admin::cases/index'
這個(gè)實(shí)例不但有名值對(duì)，而且有列表。所有第一個(gè)非空字符是“-”的行都代表一個(gè)列表的開始，并且后續(xù)縮進(jìn)行的內(nèi)容作為列表內(nèi)容。: 另一個(gè)例子： username: _ui: textbox _validations:
- [is_alpha, '用戶名只能是字母組成']
- [min_length, 5, '用戶名最少需要 5 個(gè)字符']
3、 多行文本
多行文本適合在 yaml 文件中存儲(chǔ)一些說明文字： '簡(jiǎn)介': >
快速入門教程幫助開發(fā)者了解 QeePHP 的開發(fā)模式和基本步驟，而權(quán)威指南則是開發(fā) QeePHP 應(yīng)用程序時(shí)的全面參考。
QeePHP 所有功能的使用方法、使用時(shí)機(jī)，以及該功能的使用技巧等內(nèi)容，都會(huì)在權(quán)威指南中詳細(xì)闡述。
權(quán)威指南按照不同的主題分為了數(shù)十篇文章。每篇文章圍繞各自的中心編寫內(nèi)容，讀者可以直接選擇有針對(duì)性的文章查看。
鍵名后面跟上“>”符號(hào)表示多行文本的開始。接下來每一個(gè)縮進(jìn)的行都會(huì)被視為多行文本的一部分。 例如： text: >
Sammy Sosa completed another fine season with great stats.
63 Home Runs
0.288 Batting Average
What a year!
如果要結(jié)束一個(gè)多行文本，后續(xù)的內(nèi)容只需要減少縮進(jìn)即可，例如： settings: text: >
Sammy Sosa completed another fine season with great stats.
63 Home Runs
0.288 Batting Average
What a year!
title: first post
書寫 YAML 文檔規(guī)范
在書寫 YAML 文檔時(shí)，最重要的就是注意縮進(jìn)。YAML 格式要求每一級(jí)縮進(jìn)必須是兩個(gè)空格，不能是制表字符，也不能是更多的空格。此外對(duì)于包含空格、特殊符號(hào)或漢字的鍵名和鍵值，應(yīng)該使用英文引號(hào)括起來。
總結(jié)而言，書寫 YAML 文檔的要點(diǎn)如下：
（1）注意縮進(jìn)：縮進(jìn)只能是兩個(gè)空格為一級(jí)，不能是其他字符。
（2）字符串應(yīng)該用引號(hào)：包含空格、特殊字符以及中文的字符串應(yīng)該使用英文引號(hào)括起來，不能使用中文引號(hào)。
（3）多層嵌套要注意縮進(jìn)：多層嵌套時(shí)，要注意正確的縮進(jìn)。 YAML 是一種使用很方便的格式。用于存儲(chǔ)一般的配置，YAML 有著 XML 和 PHP 數(shù)組無法比擬的優(yōu)點(diǎn)。加上 QeePHP 對(duì) YAML 的緩存能力，性能也不會(huì)是問題。
另外有需要云服務(wù)器可以了解下創(chuàng)新互聯(lián)scvps.cn，海內(nèi)外云服務(wù)器15元起步，三天無理由+7*72小時(shí)售后在線，公司持有idc許可證，提供“云服務(wù)器、裸金屬服務(wù)器、高防服務(wù)器、香港服務(wù)器、美國(guó)服務(wù)器、虛擬主機(jī)、免備案服務(wù)器”等云主機(jī)租用服務(wù)以及企業(yè)上云的綜合解決方案，具有“安全穩(wěn)定、簡(jiǎn)單易用、服務(wù)可用性高、性價(jià)比高”等特點(diǎn)與優(yōu)勢(shì)，專為企業(yè)上云打造定制，能夠滿足用戶豐富、多元化的應(yīng)用場(chǎng)景需求。
重慶分公司
重慶分公司
