YAML (YAML Ain't Markup Language) adalah bahasa penyusunan data yang mesra manusia dan merentas bahasa yang biasanya digunakan untuk fail konfigurasi dan mewakili data sebagai pemetaan, urutan dan skalar. Versi 1.2 menjadikan YAML sebagai superset ketat JSON. Dalam kerja proksi dan pengikisan, YAML muncul dalam fail konfigurasi. Sebagai contoh, konfigurasi statik proksi Envoy ditulis dalam YAML dan mentakrifkan pendengar dan kluster yang dilalui trafik.

Asas Sintaks YAML

  • Pemetaan: key: value pasangan, seperti kamus atau hash.
  • Urutan: Senarai, dengan setiap item pada barisnya sendiri yang bermula dengan -.
  • Indentasi: Dalam gaya blok, indentasi menentukan struktur, jadi ruang yang salah tempat mengubah maksud data.
  • Tiada tab: Watak tab tidak boleh digunakan untuk indentasi.
  • Komen: # memulakan komen.

Menggunakan YAML dengan Selamat dalam Konfigurasi Pengikis dan Proksi

Penyahpepijat YAML boleh melakukan lebih daripada sekadar membaca data biasa. Dokumentasi PyYAML memberi amaran bahawa memanggil yaml.load pada data dari sumber yang tidak dipercayai adalah tidak selamat, kerana ia boleh membina objek Python sewenang-wenangnya. Fungsinya yaml.safe_load hanya mengenali tag YAML standard, yang menjadikannya pilihan yang didokumenkan untuk input yang tidak dipercayai.

Rentetan Pelbagai Baris, Penanda dan Pelbagai Dokumen

  • Blok literal (|): Menjaga setiap pemisah baris dalam rentetan pelbagai baris.
  • Blok dilipat (>): Mengubah setiap pemisah baris menjadi ruang, kecuali sebelum baris kosong atau baris yang lebih terindeks.
  • Penanda dan alias: &name menandakan nod, dan *name menggunakannya semula kemudian daripada mengulanginya.
  • Pelbagai dokumen: --- menandakan permulaan kandungan dokumen, jadi satu aliran boleh memegang beberapa dokumen. ... menamatkan dokumen tanpa memulakan yang baru.

Istilah Berkaitan