Chuyển đổi JSON sang YAML

Ví dụ

Nội dung đầu vào:

{
  "name": "hyperion",
  "replicas": 3,
  "env": { "DEBUG": "false", "LOG_LEVEL": "info" },
  "command": ["php", "artisan", "queue:work"]
}

Kết quả đầu ra:

name: hyperion
replicas: 3
env:
  DEBUG: "false"
  LOG_LEVEL: info
command:
  - php
  - artisan
  - queue:work

Xác định kiểu dữ liệu

Khi các chuỗi cần được đặt trong dấu ngoặc kép

YAML tự động diễn giải một số chuỗi văn bản thành các giá trị không phải dạng chuỗi. Những giá trị có cấu trúc như vậy cần được đặt trong dấu ngoặc kép:

Bộ chuyển đổi sẽ tự động đặt dấu ngoặc kép cho những phần này và để lại các phần còn lại không đặt dấu ngoặc nhằm tăng tính dễ đọc.

Sự khác biệt trong thiết kế giữa YAML và JSON

• Bình luận: YAML hỗ trợ tính năng này (#), trong khi JSON không hỗ trợ.
• Các tên liên kết/tên tham chiếu: YAML hỗ trợ tham chiếu chéo (ví dụ: &anchor/*alias); JSON lại hiển thị dữ liệu tương ứng. Hệ thống chuyển đổi không thể tự động suy luận được các thông tin này; bạn cần thêm chúng thủ công nếu cần.
• Các chuỗi nhiều dòng: YAML sử dụng các giá trị tham số dạng khối (| giữ nguyên các dòng mới, trong khi > gộp chúng lại). Bộ chuyển đổi sử dụng những giá trị này để xử lý các chuỗi dài.
• Biểu diễn giá trị null: YAML cho phép sử dụng các giá trị null, ~ hoặc giá trị trống. Bộ chuyển đổi sẽ tự động tạo giá trị null theo mặc định.

Các lỗi phổ biến

• “Vấn đề Na Uy” của YAML 1.1. Trong YAML 1.1, NO không có dấu ngoặc kép được coi là giá trị boolean false. Hầu hết các trình phân tích hiện đại dùng YAML 1.2, nơi chỉ true/false là boolean, nhưng một số công cụ cũ vẫn có thể xử lý sai.
• Khoảng trắng ở cuối các giá trị: YAML giữ nguyên khoảng trắng này trong các đại lượng khối (block scalars), nhưng sẽ loại bỏ nó trong các đại lượng đơn giản (plain scalars). Điều này có thể gây bất ngờ nếu bạn không biết giá trị đó được biểu diễn dưới dạng nào.
• Các tab trong định dạng lồng nhau: YAML cấm sử dụng tab; hãy luôn dùng khoảng trắng thay thế.
• Các chuỗi đơn dòng rất dài: Hãy chia chúng thành các giá trị số dạng khối để tăng tính dễ đọc; bộ chuyển đổi sẽ tự động thực hiện việc này khi độ dài vượt quá ngưỡng có thể cấu hình được.