bellangelo/phpadr

A PHP based command-line interface tool for working with ADR

v1.0.3 2025-01-19 22:26 UTC

Requires

• php: >=7.2.5 || ^8.0
• ext-mbstring: *
• symfony/console: ^4.4|^5.0|^6.0|^7.0
• symfony/yaml: ^4.4|^5.0|^6.0|^7.0

Requires (Dev)

• mikey179/vfsstream: ^1.6
• php-coveralls/php-coveralls: v2.0.0
• phpunit/phpunit: ^8.0.0

MIT

• Aggelos Bellos

• documentation
• adr
• agility
• architecture-decision-records
• architecture-decision

README

A PHP based command-line interface tool for working with Architecture Decision Records (ADR).

About ADR

Architecture Decision Records (ADR) is a technique for capturing important architectural decisions, along with their context and consequences as described by Michael Nygard in his article: Documenting Architecture Decisions.

Requirements

• Requires PHP version 7.1.3 or newer
• Multibyte String extension

Installation

You can install this tool using the Composer, execute the following command.

composer require bellangelo/phpadr --dev

Usage

After of install this project you may execute the binary phpadr in your terminal:

./vendor/bin/phpadr

If to execute the command above, it will be showd a list of all avaliable tool commands.

By default the records will be stored in docs/arch, to change this workspace use the option --config with the path of the config file.

Create a new ADR

You may use the make:decision command:

./vendor/bin/phpadr make:decision <title> [<status="Accepted">] [--config="adr.yml"]

Count the ADRs

You may use the workspace:count command:

./vendor/bin/phpadr workspace:count [--config="adr.yml"]

List the ADRs

You may use the workspace:list command:

./vendor/bin/phpadr workspace:list [--config="adr.yml"]

Help

For more help execute the following command:

./vendor/bin/phpadr <command> --help