> For the complete documentation index, see [llms.txt](https://javascriptuse.gitbook.io/advanced/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://javascriptuse.gitbook.io/advanced/javascript/yaml-in-action-tutorial-series-general-huong-dan-su-dung-file-yml-yaml-co-ban.md).

# \[YAML] In Action Tutorial Series - General - Hướng dẫn sử dụng file YML YAML cơ bản

## Ví dụ hoàn thành :)

```
store: "Viblo"
address: "Asia"
fruits:
  - name: "Orange"
    price: "1$"
  - name: "Banana"
    price: "2$"
  - value: true
array:
  - 1
  - 2
  - 3
object:
  property1: value1
  property2: value2
Array
(
  [store] => Viblo
  [address] => Asia
  [fruits] => Array
  (
    [0] => Array
    (
      [name] => Orange
      [price] => 1$
    )
    [1] => Array
    (
      [name] => Banana
      [price] => 2$
    )
    [2] => Array
    (
      [value] => 1    
    )
  )
  [array] => Array
  (
    [0] => 1
    [1] => 2
    [2] => 3
  )
  [object] => Array
  (
    [property1] => value1
    [property2] => value2
  )
)
```

## In Action Tutorial Series - General - Hướng dẫn sử dụng file YML YAML cơ bản

## I. Giới thiệu <a href="#i-gioi-thieu-0" id="i-gioi-thieu-0"></a>

### 1. YML YAML là gì? <a href="#id-1-yml-yaml-la-gi-1" id="id-1-yml-yaml-la-gi-1"></a>

* YML và YAML là một ngôn ngữ đánh dấu văn bản tương tự HTML, XML.

### 2. YML khác YAML chỗ nào? <a href="#id-2-yml-khac-yaml-cho-nao-2" id="id-2-yml-khac-yaml-cho-nao-2"></a>

* Khác nhau mỗi extension thôi. Nội dung, cú pháp giống hết nhau. Do đó phần còn lại của bài viết mình sử dụng YML thôi nhé.

### 3. Tại sao chọn YML? <a href="#id-3-tai-sao-chon-yml-3" id="id-3-tai-sao-chon-yml-3"></a>

* Dễ nhìn, dễ chỉnh sửa, phù hợp với các file config cho mọi ngôn ngữ

### II. Parse YML YAML như nào? <a href="#ii-parse-yml-yaml-nhu-nao-4" id="ii-parse-yml-yaml-nhu-nao-4"></a>

Mỗi ngôn ngữ có một library để parse khác nhau. Không phải viết lại làm gì cả. Mình lấy ví dụ trong PHP

#### 1. PHP <a href="#id-1-php-5" id="id-1-php-5"></a>

Sử dụng library `symfony/yaml`

```
composer require symfony/yaml
```

Có file config.yaml như sau

```
store: "Viblo"
address: "Asia"
fruits:
  - name: "Orange"
    price: "1$"
  - name: "Banana"
    price: "2$"
```

Đọc, xử lý trong file parse.php

```
<?php
require 'vendor/autoload.php';

use Symfony\Component\Yaml\Yaml;

$yamlContent = file_get_contents('config.yaml');

$parseContent = Yaml::parse($yamlContent);

print_r($parseContent);
```

Kết quả

```
Array
(
    [store] => Viblo
    [address] => Asia
    [fruits] => Array
        (
            [0] => Array
                (
                    [name] => Orange
                    [price] => 1$
                )
            [1] => Array
                (
                    [name] => Banana
                    [price] => 2$
                )
        )
)
```

Rất đơn giản phải không nào. Mình sẽ viết lại file config dưới dạng json, php array và xml để bạn thấy rõ hơn tại sao nên dùng YML nhé ![😄](https://twemoji.maxcdn.com/2/72x72/1f604.png) **- config.php**

```
<?php
$config = [
  "store" => "Viblo",
    "address" => "Asia",
    "fruits" => [
        [
            "name" => "Orange",
            "price" => "$1"
        ],
        [
            "name" => "Banana",
            "price" => "$2"
        ]
    ]
];
// PHP gọi thẳng ra được tiện đấy :D. Nhưng project có ngôn ngữ khác parse đống này sao giờ :(
```

**- config.json**

```
{
  "store": "Viblo",
  "address": "Asia",
  "fruits": [
    {
      "name" : "Orange",
      "price" : "$1"
    },
    {
      "name" : "Banana",
      "price": "$2"
    }
  ]
}
```

**- config.xml**

```
<?xml version="1.0" encoding="UTF-8"?>
<root>
    <store>Viblo</store>
    <address>Asia</address>
    <fruits>
        <fruit>
            <name>Orange</name>
            <price>$1</price>    
        </fruit>
        <fruit>
            <name>Banana</name>
            <price>$2</price>
        </fruit>
    </fruits>
</root>
```

## III. Cú pháp <a href="#iii-cu-phap-6" id="iii-cu-phap-6"></a>

1. String

```
A string

'A singled-quoted string'

"A double-quoted string"
```

1. Number

```
# an integer
12
# a float
13.4
```

1. Boolean

```
true
false
```

1. Array

```
array1: [1,2,3]
// or
array2:
  - 1
  - 2
  - 3
```

1. Object

```
object1: {property1: value1, property2: value2}
//or
object2:
 - property1: value1
 - property2: value2
```

1. Comment

```
# this is a comment
```

Mong bài hướng dẫn này có thể giúp các bạn áp dụng YML vào dự án của mình dễ dàng hơn. Thanks for reading ![😄](https://twemoji.maxcdn.com/2/72x72/1f604.png)

Source:

* <http://symfony.com/doc/current/components/yaml.html>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://javascriptuse.gitbook.io/advanced/javascript/yaml-in-action-tutorial-series-general-huong-dan-su-dung-file-yml-yaml-co-ban.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.