PHPackages                             phpcq/author-validation - 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. phpcq/author-validation

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

phpcq/author-validation
=======================

Check if all authors of a particular file are mentioned in the copyright header.

1.5.2(3y ago)143.0k3[3 issues](https://github.com/phpcq/author-validation/issues)3MITPHPPHP ^5.6 || ^7.1

Since Jan 11Pushed 3y ago7 watchersCompare

[ Source](https://github.com/phpcq/author-validation)[ Packagist](https://packagist.org/packages/phpcq/author-validation)[ GitHub Sponsors](https://github.com/discordier)[ GitHub Sponsors](https://github.com/dmolineus)[ RSS](/packages/phpcq-author-validation/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (10)Versions (24)Used By (3)

[![Build Status](https://github.com/phpcq/author-validation/actions/workflows/diagnostics.yml/badge.svg)](https://github.com/phpcq/author-validation/actions)[![Latest Version tagged](https://camo.githubusercontent.com/ec822d1aeff6b3e680b39c57df862cd265e59b2386d5845fe678fa4e08676902/687474703a2f2f696d672e736869656c64732e696f2f6769746875622f7461672f70687063712f617574686f722d76616c69646174696f6e2e737667)](https://github.com/phpcq/author-validation/tags)[![Latest Version on Packagist](https://camo.githubusercontent.com/8572b6917840e37898d60fefd4c3f5834db257071e63b8a2cb8e9cefcb8f261b/687474703a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f70687063712f617574686f722d76616c69646174696f6e2e737667)](https://packagist.org/packages/phpcq/author-validation)[![Installations via composer per month](https://camo.githubusercontent.com/7a2b279b6853f936f465fc7d7d764611e9bbafd447a4ccf7949d9e298b2dbea5/687474703a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f70687063712f617574686f722d76616c69646174696f6e2e737667)](https://packagist.org/packages/phpcq/author-validation)

Validate the author information within PHP files, composer.json, bower.json or packages.json.
=============================================================================================

[](#validate-the-author-information-within-php-files-composerjson-bowerjson-or-packagesjson)

This is useful to ensure that all authors (from git history) mentioned in all PHP files, the `composer.json`, `bower.json` and `packages.json`.

Usage
-----

[](#usage)

Add to your `composer.json` in the `require-dev` section:

```
"phpcq/author-validation": "~1.0"

```

Call the binary:

```
./vendor/bin/check-author.php

```

Optionally pass a path to check:

```
./vendor/bin/check-author.php /path/to/some/repository/also/with/subdir

```

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

[](#configuration)

Optionally you can pass the path to a config file (defaults to .check-author.yml) which shall be used.

```
# Example .check-author.yml

# Map multiple authors to a single one (aliasing of contributors).
mapping:
  # original: alias
  "John Doe ": "John Doe "
  # or original: [multiple aliases]
  "John Doe ": ["John Doe ", "Acme Inc "]
  # or
  "John Doe ":
    - "John Doe "
    - "Acme Inc "

# Ignore commits from these authors (equivalent to cmd line parameter --ignore=...)
ignore:
  - Build Bot

# If present, scan only these and not the whole base dir (equivalent to cmd line arguments).
# Values must either be absolute paths or relative to the current directory.
include:
  - src

# Paths to exclude from scanning (equivalent to cmd line parameter --exclude=...)
exclude:
  - Foo.php
  - /tests/*
  - */languages

# Enforce copy-left author for certain files.
copy-left:
  "John Doe ": "/library"
  # or
  "John Doe ": ["/library", "File.php"]
  # or
  "John Doe ":
    - "File.php"

# Add additional author metadata. It is used by some comparator handlers when outputting diff format.
# Author metadata of the config file is prioritized over extracted metadata from the files.

metadata:
  "John Doe ":
    role:     "Translator"
    homepage: "http:/www.example.org"

```

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity29

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~138 days

Recently: every ~348 days

Total

22

Last Release

1237d ago

PHP version history (6 changes)1.0.0PHP &gt;=5.3.4

1.1.5PHP ^5.4 | ^7.0

1.1.7PHP ^5.4 || ^7.0

1.2.0PHP ^5.6 || ^7.0

1.5.0PHP ^5.6 | ^7.1

1.5.2PHP ^5.6 || ^7.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/44649522?v=4)[xtra](/maintainers/xtra)[@xtra](https://github.com/xtra)

![](https://avatars.githubusercontent.com/u/8189209?v=4)[netzmacht](/maintainers/netzmacht)[@netzmacht](https://github.com/netzmacht)

---

Top Contributors

[![baumannsven](https://avatars.githubusercontent.com/u/2493263?v=4)](https://github.com/baumannsven "baumannsven (100 commits)")[![discordier](https://avatars.githubusercontent.com/u/940331?v=4)](https://github.com/discordier "discordier (80 commits)")[![tristanlins](https://avatars.githubusercontent.com/u/343404?v=4)](https://github.com/tristanlins "tristanlins (20 commits)")[![dmolineus](https://avatars.githubusercontent.com/u/1186266?v=4)](https://github.com/dmolineus "dmolineus (14 commits)")

---

Tags

tool

### Embed Badge

![Health badge](/badges/phpcq-author-validation/health.svg)

```
[![Health](https://phpackages.com/badges/phpcq-author-validation/health.svg)](https://phpackages.com/packages/phpcq-author-validation)
```

###  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)[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)[symplify/monorepo-builder

Not only Composer tools to build a Monorepo.

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

Drupal is an open source content management platform powering millions of websites and applications.

19562.3M1.3k](/packages/drupal-core)[sulu/sulu

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

1.3k1.3M152](/packages/sulu-sulu)[contao/core-bundle

Contao Open Source CMS

1231.6M2.4k](/packages/contao-core-bundle)

PHPackages © 2026

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