PHPackages                             yannoff/yamltools - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Parsing &amp; Serialization](/categories/parsing)
4. /
5. yannoff/yamltools

ActiveConsole-script[Parsing &amp; Serialization](/categories/parsing)

yannoff/yamltools
=================

A command-line Swiss-Knife for YAML files

1.5.0(2y ago)143[1 PRs](https://github.com/yannoff/yamltools/pulls)MITPHPPHP &gt;=5.5

Since Mar 4Pushed 2y ago1 watchersCompare

[ Source](https://github.com/yannoff/yamltools)[ Packagist](https://packagist.org/packages/yannoff/yamltools)[ Docs](https://github.com/yannoff/yamltools)[ RSS](/packages/yannoff-yamltools/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (10)Dependencies (4)Versions (19)Used By (0)

yannoff/yamltools
=================

[](#yannoffyamltools)

The YAML Tools Project: A command-line swiss-knife for `YAML`, written in PHP.

[![Latest Stable Version](https://camo.githubusercontent.com/d675dcb5500697e907a79672d604074de8ada36b960301a2854bb93773c54ee4/68747470733a2f2f706f7365722e707567782e6f72672f79616e6e6f66662f79616d6c746f6f6c732f762f737461626c65)](https://packagist.org/packages/yannoff/yamltools)[![Total Downloads](https://camo.githubusercontent.com/0b6d40c708064c157401c9a59885508b14813f33ede5719c3707d0387f1dd5e6/68747470733a2f2f706f7365722e707567782e6f72672f79616e6e6f66662f79616d6c746f6f6c732f646f776e6c6f616473)](https://packagist.org/packages/yannoff/yamltools)[![License](https://camo.githubusercontent.com/eed7c7230367b55b53b100eabbb8e65f5130b811828c35820f19a5dccf042ab2/68747470733a2f2f706f7365722e707567782e6f72672f79616e6e6f66662f79616d6c746f6f6c732f6c6963656e7365)](https://packagist.org/packages/yannoff/yamltools)

Requirements
------------

[](#requirements)

- `php` 5.6.40+
- `go-md2man` for advanced configuration (see [Advanced install section](#advanced-install) for details)

Installation
------------

[](#installation)

### Quick install

[](#quick-install)

#### Option A: As a composer global package

[](#option-a-as-a-composer-global-package)

*The [yamltools phar](https://github.com/yannoff/yamltools/releases/latest/download/yamltools) may be installed as a global package using [composer](https://getcomposer.org/) or [offenbach](https://github.com/yannoff/offenbach).*

```
composer global require yannoff/yamltools
```

or

```
offenbach global require yannoff/yamltools
```

> *The `$COMPOSER_HOME/vendor/bin` directory have to be in the `PATH` system-wide environment variable.*

#### Option B: Manual download

[](#option-b-manual-download)

Get the latest release and install it

```
curl -Lo /usr/bin/yamltools https://github.com/yannoff/yamltools/releases/latest/download/yamltools
chmod +x /usr/bin/yamltools

```

> *The `/usr/bin/yamltools` path is just an example, fell free to replace by any custom binary file path.*

### Advanced install

[](#advanced-install)

1. Clone or fetch a zipball from this repository
2. Run configure if you want to fine-tune installation parameters (run `./configure --help` to see available options and invocation *modus operandi*).
3. Compille &amp; install: `make && sudo make install`

Usage
-----

[](#usage)

The YAML Tools Project comes with several utilities to handle YAML from the command-line:

- [Converter](doc/converter.md) : Juggle easily between `JSON` &amp; `YAML` formats
- [Comments](doc/comments.md) : Manipulate YAML comments: export, import &amp; merge

Acknowledgement
---------------

[](#acknowledgement)

The YAML Tools Project is based on the well-known [symfony/yaml](https://github.com/symfony/yaml) component, which implements its own engine to dump/parse YAML data.

Two reasons motivated the choice:

- The component is a standalone, pure PHP implementation: no need to have the [Yaml PHP extension](http://pecl.php.net/package/yaml) installed, guaranteeing a wider support for many platforms.
- The dumps are more pretty-print oriented, and more flexible, allowing to customize indentation and inline wrapping level.

The major drawback on the other hand is that the component is [not fully compliant](https://symfony.com/doc/3.4/components/yaml/yaml_format.html#unsupported-yaml-features) with YAML Standards.

Credits
-------

[](#credits)

Licensed under the [MIT License](LICENSE).

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 91.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~104 days

Recently: every ~140 days

Total

17

Last Release

1000d ago

PHP version history (2 changes)1.4.0PHP &gt;=5.6.40

1.4.6PHP &gt;=5.5

### Community

Maintainers

![](https://www.gravatar.com/avatar/0f7d03ec2e1304f585bacac055f09969294b8c08146d6be1d00504193be3bc9e?d=identicon)[yannoff](/maintainers/yannoff)

---

Top Contributors

[![yannoff](https://avatars.githubusercontent.com/u/20049273?v=4)](https://github.com/yannoff "yannoff (89 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (8 commits)")

---

Tags

commentsjsonjson-parserjson-to-yamlyamlyaml-parseryaml-to-json

### Embed Badge

![Health badge](/badges/yannoff-yamltools/health.svg)

```
[![Health](https://phpackages.com/badges/yannoff-yamltools/health.svg)](https://phpackages.com/packages/yannoff-yamltools)
```

###  Alternatives

[symfony/yaml

Loads and dumps YAML files

3.9k816.3M10.7k](/packages/symfony-yaml)[symfony/serializer

Handles serializing and deserializing data structures, including object graphs, into array structures or other formats like XML and JSON.

2.5k319.4M3.2k](/packages/symfony-serializer)[twig/twig

Twig, the flexible, fast, and secure template language for PHP

8.4k457.8M6.8k](/packages/twig-twig)[symfony/string

Provides an object-oriented API to strings and deals with bytes, UTF-8 code points and grapheme clusters in a unified way

1.8k759.1M1.2k](/packages/symfony-string)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6941.5M396](/packages/drupal-core-recommended)[tempest/framework

The PHP framework that gets out of your way.

2.2k31.1k12](/packages/tempest-framework)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
