YAML** (YAML Ain't Markup Language) 是一種**人類可讀**的數據序列化語言,語法極簡,支援層級結構、列表、映射,廣泛用於配置文件 (Docker Compose、Kubernetes、GitHub Actions、Symfony、Laravel .env 等)。
# 註釋
key: value # 鍵值對 (冒號後必須有空格)
number: 42 # 數字自動識別類型
float: 3.14
bool: true # true/false/yes/no/on/off
null: ~ # 或 null
str: "雙引號支援轉義\n" # 雙引號
str: '單引號字面量' # 單引號
multi: | # 字面量塊 (保留換行)
第一行
第二行
multi: > # 折疊塊 (換行轉空格)
這是一段
長文本
list: # 列表 (序列)
- item1
- item2
- item3
inline_list: [item1, item2] # 行內列表
map: # 映射 (字典)
key1: val1
key2: val2
inline_map: {k1: v1, k2: v2} # 行內映射
anchor: &default # 錨點
alias: *default # 別名引用
merge: # 合併 (<<)
<<: *default
extra: value
<?php
// 需安裝 symfony/yaml 或 php-yaml 擴展
composer require symfony/yaml
use Symfony\Component\Yaml\Yaml;
$yaml = file_get_contents('config.yaml');
$config = Yaml::parse($yaml);
// $config 為 PHP 數組
// 導出
$yamlStr = Yaml::dump($config, 4); // 4 空格縮進
file_put_contents('output.yaml', $yamlStr);
?>
| 特性 | YAML | JSON | XML |
|---|---|---|---|
| 可讀性 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
| 註釋 | 支援 | 不支援 | 支援 |
| 類型 | 豐富 (日期、二進制等) | 基本 | 需 Schema |
| 解析速度 | 中 | 快 | 慢 |
| 流式解析 | 困難 | 支援 | 支援 |
| 常用場景 | 配置文件 | API 傳輸 | 文檔/舊系統 |
key: value (非 key:value)。yes/no/on/off 會被解析為 true/false,字符串 "yes" 須加引號。<< 僅在映射中有效,不可濫用造成循環引用。