萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

YAML 入門教程:比 JSON 更易讀的配置語言,Symfony/Compose 必備

什麼是 YAML?

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 解析 YAML

<?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 vs JSON vs XML

特性YAMLJSONXML
可讀性⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐
註釋支援不支援支援
類型豐富 (日期、二進制等)基本需 Schema
解析速度中快慢
流式解析困難支援支援
常用場景配置文件API 傳輸文檔/舊系統

常見陷阱

  • 縮進必須用空格 (通常 2 空格),**禁用 Tab**。
  • 冒號後**必須有一個空格**:key: value (非 key:value)。
  • 字符串含特殊字符 (:、#、[、]、{、}、、、&、*、!、|、>、%、@、`) 建議加引號。
  • 布爾值 yes/no/on/off 會被解析為 true/false,字符串 "yes" 須加引號。
  • 合併鍵 << 僅在映射中有效,不可濫用造成循環引用。
copyright © 萬盛學電腦網 all rights reserved