PHPackages                             dantleech/gherkin-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. [Utility &amp; Helpers](/categories/utility)
4. /
5. dantleech/gherkin-lint

ActiveProject[Utility &amp; Helpers](/categories/utility)

dantleech/gherkin-lint
======================

Gherkin linter

0.2.3(1y ago)46177.5k↓14%5[4 issues](https://github.com/dantleech/gherkin-lint-php/issues)9MITPHPPHP ^8.1CI passing

Since Jun 26Pushed 1mo ago1 watchersCompare

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

READMEChangelog (6)Dependencies (12)Versions (12)Used By (9)

Gherkin Lint for PHP
====================

[](#gherkin-lint-for-php)

This package provides a Gherkin linter for PHP heavily inspired by [vsiakka/gherkin-lint](https://github.com/vsiakka/gherkin-lint) and using the [PHP Gherkin Parser](https://packagist.org/packages/cucumber/gherkin).

Contents
--------

[](#contents)

- [Usage](#usage)
- [Configuration](#configuration)
- [Rules](docs/rules.md)
- [Disabling Rules](#disabling-rules)

Usage
-----

[](#usage)

> **NOTE**: Gherkin Lint requires PHP 8.1

Install with Composer:

```
$ composer require --dev dantleech/gherkin-lint

```

Lint your feature files:

```
$ ./vendor/bin/gherkinlint lint features/

```

[![image](https://user-images.githubusercontent.com/530801/175784302-398ca341-ae67-4b63-8b8d-b7e705286ab3.png)](https://user-images.githubusercontent.com/530801/175784302-398ca341-ae67-4b63-8b8d-b7e705286ab3.png)

To see the available and enabled rules run:

```
$ ./vendor/bin/gherkinlint rules

```

[![image](https://user-images.githubusercontent.com/530801/175804779-0fe10523-c410-4545-b564-c23e896b2133.png)](https://user-images.githubusercontent.com/530801/175804779-0fe10523-c410-4545-b564-c23e896b2133.png)

Configuration
-------------

[](#configuration)

By default all rules are enabled. In order to customise or disable them create a config file `gherkinlint.json`:

```
{
    "rules": {
        "allowed-tags": {
            "allow": ["@my-special-tag", "@my-other-tag"]
        },
        "filename": {
            "enabled": false
        }
    }
}

```

Use the `rules` command to see which rules are enabled.

Disabling Rules
---------------

[](#disabling-rules)

Rules can be disabled by adding a comment before the Feature declaration:

```
# @gherkinlint-disable-rule keyword-order
Feature: My feature with strange keyword orders
```

Disable multiple rules with comma separation:

```
# @gherkinlint-disable-rule keyword-order, someother-rule
Feature: My feature with strange keyword orders
```

Contributing
------------

[](#contributing)

Make a pull request!

###  Health Score

49

—

FairBetter than 95% of packages

Maintenance62

Regular maintenance activity

Popularity47

Moderate usage in the ecosystem

Community24

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 95.2% 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 ~176 days

Total

5

Last Release

709d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/24ec7d5d6b7ea54007be5d7b4f43800381cc1e22929f7d2276fba30e497fdfa6?d=identicon)[dantleech](/maintainers/dantleech)

---

Top Contributors

[![dantleech](https://avatars.githubusercontent.com/u/530801?v=4)](https://github.com/dantleech "dantleech (160 commits)")[![darkanakin41](https://avatars.githubusercontent.com/u/6129533?v=4)](https://github.com/darkanakin41 "darkanakin41 (2 commits)")[![dkarlovi](https://avatars.githubusercontent.com/u/209225?v=4)](https://github.com/dkarlovi "dkarlovi (2 commits)")[![DZunke](https://avatars.githubusercontent.com/u/1244235?v=4)](https://github.com/DZunke "DZunke (2 commits)")[![alexander-schranz](https://avatars.githubusercontent.com/u/1698337?v=4)](https://github.com/alexander-schranz "alexander-schranz (1 commits)")[![annavanbiemen](https://avatars.githubusercontent.com/u/1430899?v=4)](https://github.com/annavanbiemen "annavanbiemen (1 commits)")

---

Tags

behatgherkinlinterphp

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/dantleech-gherkin-lint/health.svg)

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

###  Alternatives

[symfony/maker-bundle

Symfony Maker helps you create empty commands, controllers, form classes, tests and more so you can forget about writing boilerplate code.

3.4k111.1M568](/packages/symfony-maker-bundle)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[symplify/monorepo-builder

Not only Composer tools to build a Monorepo.

5205.3M82](/packages/symplify-monorepo-builder)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)

PHPackages © 2026

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