Read and manipulate composer.json

2.0.0 2023-04-02 18:34 UTC

This package is auto-updated.

Last update: 2024-05-07 14:42:13 UTC


Tests Latest Stable Version Total Downloads License Test Coverage Maintainability

A small PHP library for manipulating and reading the composer.json file. It allows you to add new sections, check if it's writable/readable, or retrieve information from the composer schema such as description, title, and more.


Install via Composer:

composer require nadar/php-composer-reader


To load the composer.json file into ComposerReader:

require 'vendor/autoload.php';

$reader = new ComposerReader('path/to/composer.json');

if (!$reader->canRead()) {
   throw new Exception("Unable to read the JSON file.");

if (!$reader->canWrite()) {
   throw new Exception("Unable to write to the JSON file.");

// Dump the full content

Reading Section Data

Retrieve an array of objects for each package in the require section of the composer.json file:

$reader = new ComposerReader('path/to/composer.json');
$section = new RequireSection($reader);

foreach ($section as $package) {
    echo $package->name . ' with ' . $package->constraint;

    // Check if the package version is greater than a given version constraint.
    if ($package->greaterThan('^6.5')) {
        echo "Numerous releases available!";

Retrieve an array of objects for each PSR definition in the autoload section of the composer.json file:

$reader = new ComposerReader('path/to/composer.json');
$section = new AutoloadSection($reader, AutoloadSection::TYPE_PSR4);

foreach ($section as $autoload) {
    echo $autoload->namespace . ' with ' . $autoload->source;

The following section readers are available for the composer schema (Composer Schema Documentation):

Section Class
require RequireSection
require-dev RequireDevSection
autoload AutoloadSection
autoload-dev AutoloadDevSection

Additional schema information can be retrieved from the ComposerReader object with: $reader->contentSection('extra', null);

Changing Section Data

Add a new PSR autoload definition to an existing composer.json file and save it:

$reader = new ComposerReader('path/to/composer.json');

// Generate a new autoload section object
$new = new Autoload($reader, 'Foo\\Bar\\', 'src/foo/bar', AutoloadSection::TYPE_PSR4);

// Store the new autoload object in the autoload section and save
$section = new AutoloadSection($reader);

Running Commands

To perform composer operations, use the runCommand() method:

$reader = new ComposerReader('path/to/composer.json');
$reader->runCommand('dump-autoload'); // This is equivalent to running `composer dump-autoload`

This attempts to execute the dump-autoload command for the specified composer.json file. This requires a globally installed Composer command on your system (Install Composer globally).