PHPackages                             j13k/yaml-lint - 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. [CLI &amp; Console](/categories/cli)
4. /
5. j13k/yaml-lint

ActiveLibrary[CLI &amp; Console](/categories/cli)

j13k/yaml-lint
==============

A compact command line utility for checking YAML file syntax

1.1.7(6mo ago)161.1M—8.2%5[9 issues](https://github.com/j13k/yaml-lint/issues)[4 PRs](https://github.com/j13k/yaml-lint/pulls)19MITPHPPHP &gt;=5.6CI passing

Since Mar 3Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/j13k/yaml-lint)[ Packagist](https://packagist.org/packages/j13k/yaml-lint)[ Docs](https://github.com/j13k/yaml-lint)[ RSS](/packages/j13k-yaml-lint/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (9)Dependencies (4)Versions (17)Used By (19)

yaml-lint
=========

[](#yaml-lint)

[![Latest Version on Packagist](https://camo.githubusercontent.com/d747beafc0e8d687273d86149a7afda607cd12b1ce41cba55b6d318264014eda/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a31336b2f79616d6c2d6c696e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/j13k/yaml-lint)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![Total Downloads](https://camo.githubusercontent.com/253719326820cff2f0afc363f83c14213292190b4fba8afc05097ef6060aeaf2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a31336b2f79616d6c2d6c696e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/j13k/yaml-lint/stats)[![Monthly Downloads](https://camo.githubusercontent.com/125c99ef027fdc2e0a6d4d2c0e679dc8e381f151422a524e138bc5a997dda817/68747470733a2f2f706f7365722e707567782e6f72672f6a31336b2f79616d6c2d6c696e742f642f6d6f6e74686c79)](https://packagist.org/packages/j13k/yaml-lint/stats)[![CI](https://github.com/j13k/yaml-lint/actions/workflows/ci.yml/badge.svg)](https://github.com/j13k/yaml-lint/actions/workflows/ci.yml)

A compact command line linting tool for validating YAML files, using the parsing facility of the [Symfony Yaml Component](https://github.com/symfony/yaml).

Usage
-----

[](#usage)

```
usage: yaml-lint [options] [input source]

  input source      Path to file(s), or "-" to read from standard input

  -q, --quiet       Restrict output to syntax errors
  -t, --parse-tags  Enable parsing of custom YAML tags (symfony/yaml 3+ only)
  -h, --help        Display this help
  -V, --version     Display application version

```

Install
-------

[](#install)

### Composer

[](#composer)

To get started using yaml-lint in a project, install it with Composer:

```
composer require --dev j13k/yaml-lint
```

It can then be run from the project's `vendor/bin` directory.

To set up yaml-lint globally, install it in the Composer home directory:

```
composer global require j13k/yaml-lint
```

It can then be run from the `bin` directory of Composer home (typically `~/.composer/vendor/bin`).

Note

**Binary Name Conflict**: Both `j13k/yaml-lint` and `symfony/yaml` provide a `yaml-lint` binary. If you see this message during installation:

```
Skipped installation of bin bin/yaml-lint for package j13k/yaml-lint:
name conflicts with an existing file

```

You can either call the binary directly with `vendor/j13k/yaml-lint/bin/yaml-lint`, or create a symlink:

```
ln -sf ../j13k/yaml-lint/bin/yaml-lint vendor/bin/yaml-lint
```

See [\#181](https://github.com/j13k/yaml-lint/issues/181) for details.

### Binary

[](#binary)

A binary edition , `yaml-lint.phar`, is available for download with [each release](https://github.com/j13k/yaml-lint/releases). This embeds the latest stable version of the Symfony Yaml component that is current at the time of the release.

The binary can be conveniently installed using [PHIVE](https://phar.io/):

```
phive install yaml-lint
```

#### Verifying Signatures

[](#verifying-signatures)

Release binaries are signed with GPG. To verify the signature:

1. Download both `yaml-lint.phar` and `yaml-lint.phar.asc` from the [releases page](https://github.com/j13k/yaml-lint/releases)
2. Import the public key:

    ```
    gpg --recv-keys 38A182AB413064D7
    ```

    Or download it from this repository:

    ```
    curl -O https://raw.githubusercontent.com/j13k/yaml-lint/master/j13k_users_noreply_github_com.pub
    gpg --import j13k_users_noreply_github_com.pub
    ```
3. Verify the signature:

    ```
    gpg --verify yaml-lint.phar.asc yaml-lint.phar
    ```

    You should see: `Good signature from "John Fitzpatrick (Software signing key) "`

### Docker

[](#docker)

yaml-lint is bundled in the [phpqa Docker image](https://hub.docker.com/r/jakzal/phpqa/), which provides a suite of static analysis tools for PHP. See the [phpqa project](https://github.com/jakzal/phpqa) for [installation and usage instructions](https://github.com/jakzal/phpqa#running-tools).

Change log
----------

[](#change-log)

Please see [CHANGELOG](CHANGELOG.md) for information on what has changed recently.

Credits
-------

[](#credits)

- [yaml-lint contributors](https://github.com/j13k/yaml-lint/contributors)
- [Symfony Yaml contributors](https://github.com/symfony/yaml/graphs/contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [LICENCE](LICENSE) for more information.

###  Health Score

55

—

FairBetter than 98% of packages

Maintenance68

Regular maintenance activity

Popularity47

Moderate usage in the ecosystem

Community26

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 55.4% 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 ~440 days

Recently: every ~692 days

Total

9

Last Release

206d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6d4d34833f1ff6b6fa45a8351310275ff6c6387a4cf5e4695afc3a269b971b68?d=identicon)[j13k](/maintainers/j13k)

---

Top Contributors

[![j13k](https://avatars.githubusercontent.com/u/1084378?v=4)](https://github.com/j13k "j13k (169 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (130 commits)")[![staabm](https://avatars.githubusercontent.com/u/120441?v=4)](https://github.com/staabm "staabm (3 commits)")[![neilime](https://avatars.githubusercontent.com/u/314088?v=4)](https://github.com/neilime "neilime (1 commits)")[![OndraM](https://avatars.githubusercontent.com/u/793041?v=4)](https://github.com/OndraM "OndraM (1 commits)")[![wow-apps](https://avatars.githubusercontent.com/u/2779949?v=4)](https://github.com/wow-apps "wow-apps (1 commits)")

---

Tags

command-linelintphpsyntax-checkeryamlyaml-lintyamllintclisymfonyutilityyamlymllintsyntax

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleECS

Type Coverage Yes

### Embed Badge

![Health badge](/badges/j13k-yaml-lint/health.svg)

```
[![Health](https://phpackages.com/badges/j13k-yaml-lint/health.svg)](https://phpackages.com/packages/j13k-yaml-lint)
```

###  Alternatives

[nunomaduro/collision

Cli error handling for console/command-line PHP applications.

4.6k331.8M8.5k](/packages/nunomaduro-collision)[nunomaduro/laravel-console-task

Laravel Console Task is a output method for your Laravel/Laravel Zero commands.

2582.1M11](/packages/nunomaduro-laravel-console-task)[rahul900day/laravel-console-spinner

Laravel Console Spinner is a spinner output for Laravel command line.

76125.4k1](/packages/rahul900day-laravel-console-spinner)[misterion/ko-worker

Ko-worker project is a base to develop amqp based message dispatchers

2713.4k](/packages/misterion-ko-worker)[access9/dbtabledump

The database table dumper

1014.0k](/packages/access9-dbtabledump)[amercier/cli-helpers

Utility classes to write PHP command-line scripts

258.8k2](/packages/amercier-cli-helpers)

PHPackages © 2026

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