# composer/composer architecture

> Architecture diagram of the GitHub repository composer/composer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/composer/composer
- Repository: https://github.com/composer/composer

## Overview

Composer is a PHP dependency manager: users declare project requirements, then Composer resolves packages, downloads them, installs them, and can generate an autoloader. Its repository, package, platform, and security-policy capabilities support that workflow; plugins and scripts extend command and lifecycle behavior. The map also includes repository search, archive creation, and advisory auditing. Evidence is limited to the README and indexed source references; where wiring was not shown, the graph omits the connection rather than assuming one.

Main entry points: [`src/Composer/Installer.php`](https://github.com/composer/composer/blob/main/src/Composer/Installer.php) (Install orchestration), [`src/Composer/Command`](https://github.com/composer/composer/tree/main/src/Composer/Command) (Project commands), [`src/Composer/Console/Application.php`](https://github.com/composer/composer/blob/main/src/Composer/Console/Application.php) (CLI application), [`src/Composer/Composer.php`](https://github.com/composer/composer/blob/main/src/Composer/Composer.php) (Runtime context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI and project config"]
  node_cli["CLI application<br/>[Application.php]"]
  node_commands["Project commands"]
  node_config["Project configuration<br/>[Config.php]"]
  node_composer["Runtime context<br/>[Composer.php]"]
end

subgraph group_resolve["Packages and resolution"]
  node_package["Package model<br/>[Package.php]"]
  node_version["Version parsing<br/>[VersionParser.php]"]
  node_platform["Platform packages"]
  node_resolver["Dependency solver<br/>[Solver.php]"]
end

subgraph group_acquire["Repositories and downloads"]
  node_repositories["Repository manager"]
  node_remote["Package metadata"]
  node_vcs["VCS repositories<br/>[VcsRepository.php]"]
  node_download["Download manager"]
  node_search["Package search<br/>[SearchCommand.php]"]
end

subgraph group_install["Install and extend"]
  node_installer["Install orchestration<br/>[Installer.php]"]
  node_installmgr["Installation manager"]
  node_autoload["Autoload generation"]
  node_plugins["Plugin manager<br/>[PluginManager.php]"]
  node_events["Events and scripts"]
end

subgraph group_security["Security and archives"]
  node_audit["Advisory auditing<br/>[Auditor.php]"]
  node_archive["Package archiving<br/>[ArchiveManager.php]"]
end

node_user(("Project user"))
node_packagist[("Package registry")]

node_user -->|"runs commands"| node_cli
node_user -->|"declares requirements"| node_config
node_cli -->|"runs install"| node_installer
node_cli -->|"creates context"| node_composer
node_commands -.->|"registers commands"| node_cli
node_composer -->|"uses configuration"| node_config
node_installer -.->|"uses repositories"| node_repositories
node_installer -.->|"resolves dependencies"| node_resolver
node_resolver -.->|"evaluates packages"| node_package
node_resolver -.->|"checks platform"| node_platform
node_version -->|"parses constraints"| node_platform
node_repositories -->|"creates repository"| node_remote
node_repositories -->|"uses context"| node_composer
node_remote -->|"loads package data"| node_package
node_remote -.->|"fetches metadata"| node_packagist
node_vcs -->|"loads package data"| node_package
node_installer -.->|"downloads packages"| node_download
node_installer -.->|"applies operations"| node_installmgr
node_installmgr -->|"downloads files"| node_download
node_installer -.->|"generates autoload"| node_autoload
node_composer -->|"holds manager"| node_plugins
node_plugins -->|"subscribes handlers"| node_events
node_commands -.->|"includes search"| node_search
node_search -.->|"searches packages"| node_packagist
node_commands -.->|"includes audit"| node_audit
node_commands -.->|"includes archive"| node_archive
node_archive -->|"uses downloads"| node_download

click node_cli "https://github.com/composer/composer/blob/main/src/Composer/Console/Application.php"
click node_commands "https://github.com/composer/composer/tree/main/src/Composer/Command"
click node_config "https://github.com/composer/composer/blob/main/src/Composer/Config.php"
click node_composer "https://github.com/composer/composer/blob/main/src/Composer/Composer.php"
click node_package "https://github.com/composer/composer/blob/main/src/Composer/Package/Package.php"
click node_version "https://github.com/composer/composer/blob/main/src/Composer/Package/Version/VersionParser.php"
click node_platform "https://github.com/composer/composer/blob/main/src/Composer/Repository/PlatformRepository.php"
click node_resolver "https://github.com/composer/composer/blob/main/src/Composer/DependencyResolver/Solver.php"
click node_repositories "https://github.com/composer/composer/blob/main/src/Composer/Repository/RepositoryManager.php"
click node_remote "https://github.com/composer/composer/blob/main/src/Composer/Repository/ComposerRepository.php"
click node_vcs "https://github.com/composer/composer/blob/main/src/Composer/Repository/VcsRepository.php"
click node_download "https://github.com/composer/composer/blob/main/src/Composer/Downloader/DownloadManager.php"
click node_installer "https://github.com/composer/composer/blob/main/src/Composer/Installer.php"
click node_installmgr "https://github.com/composer/composer/blob/main/src/Composer/Installer/InstallationManager.php"
click node_autoload "https://github.com/composer/composer/blob/main/src/Composer/Autoload/AutoloadGenerator.php"
click node_plugins "https://github.com/composer/composer/blob/main/src/Composer/Plugin/PluginManager.php"
click node_events "https://github.com/composer/composer/blob/main/src/Composer/EventDispatcher/EventDispatcher.php"
click node_audit "https://github.com/composer/composer/blob/main/src/Composer/Advisory/Auditor.php"
click node_archive "https://github.com/composer/composer/blob/main/src/Composer/Package/Archiver/ArchiveManager.php"
click node_search "https://github.com/composer/composer/blob/main/src/Composer/Command/SearchCommand.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_commands,node_config,node_composer,node_user toneBlue
class node_package,node_version,node_platform,node_resolver,node_packagist toneAmber
class node_repositories,node_remote,node_vcs,node_download,node_search toneMint
class node_installer,node_installmgr,node_autoload,node_plugins,node_events toneRose
class node_audit,node_archive toneIndigo
```

## Components

### CLI and project config

- [CLI application](https://github.com/composer/composer/blob/main/src/Composer/Console/Application.php): `src/Composer/Console/Application.php`
- [Project commands](https://github.com/composer/composer/tree/main/src/Composer/Command): `src/Composer/Command`
- [Project configuration](https://github.com/composer/composer/blob/main/src/Composer/Config.php): `src/Composer/Config.php`
- [Runtime context](https://github.com/composer/composer/blob/main/src/Composer/Composer.php): `src/Composer/Composer.php`

### Packages and resolution

- [Package model](https://github.com/composer/composer/blob/main/src/Composer/Package/Package.php): `src/Composer/Package/Package.php`
- [Version parsing](https://github.com/composer/composer/blob/main/src/Composer/Package/Version/VersionParser.php): `src/Composer/Package/Version/VersionParser.php`
- [Platform packages](https://github.com/composer/composer/blob/main/src/Composer/Repository/PlatformRepository.php): `src/Composer/Repository/PlatformRepository.php`
- [Dependency solver](https://github.com/composer/composer/blob/main/src/Composer/DependencyResolver/Solver.php): `src/Composer/DependencyResolver/Solver.php`

### Repositories and downloads

- [Repository manager](https://github.com/composer/composer/blob/main/src/Composer/Repository/RepositoryManager.php): `src/Composer/Repository/RepositoryManager.php`
- [Package metadata](https://github.com/composer/composer/blob/main/src/Composer/Repository/ComposerRepository.php): `src/Composer/Repository/ComposerRepository.php`
- [VCS repositories](https://github.com/composer/composer/blob/main/src/Composer/Repository/VcsRepository.php): `src/Composer/Repository/VcsRepository.php`
- [Download manager](https://github.com/composer/composer/blob/main/src/Composer/Downloader/DownloadManager.php): `src/Composer/Downloader/DownloadManager.php`
- [Package search](https://github.com/composer/composer/blob/main/src/Composer/Command/SearchCommand.php): `src/Composer/Command/SearchCommand.php`

### Install and extend

- [Install orchestration](https://github.com/composer/composer/blob/main/src/Composer/Installer.php): `src/Composer/Installer.php`
- [Installation manager](https://github.com/composer/composer/blob/main/src/Composer/Installer/InstallationManager.php): `src/Composer/Installer/InstallationManager.php`
- [Autoload generation](https://github.com/composer/composer/blob/main/src/Composer/Autoload/AutoloadGenerator.php): `src/Composer/Autoload/AutoloadGenerator.php`
- [Plugin manager](https://github.com/composer/composer/blob/main/src/Composer/Plugin/PluginManager.php): `src/Composer/Plugin/PluginManager.php`
- [Events and scripts](https://github.com/composer/composer/blob/main/src/Composer/EventDispatcher/EventDispatcher.php): `src/Composer/EventDispatcher/EventDispatcher.php`

### Security and archives

- [Advisory auditing](https://github.com/composer/composer/blob/main/src/Composer/Advisory/Auditor.php): `src/Composer/Advisory/Auditor.php`
- [Package archiving](https://github.com/composer/composer/blob/main/src/Composer/Package/Archiver/ArchiveManager.php): `src/Composer/Package/Archiver/ArchiveManager.php`

### Other components

- **Project user**
- **Package registry**

## Connections

- Project user → CLI application: runs commands (evidence: `README.md`)
- Project user → Project configuration: declares requirements (evidence: `README.md`)
- CLI application → Install orchestration: runs install (evidence: `src/Composer/Console/Application.php`)
- CLI application → Runtime context: creates context (evidence: `src/Composer/Console/Application.php`)
- Project commands → CLI application: registers commands (evidence: `src/Composer/Console/Application.php`)
- Runtime context → Project configuration: uses configuration (evidence: `src/Composer/Repository/ComposerRepository.php`)
- Install orchestration → Repository manager: uses repositories
- Install orchestration → Dependency solver: resolves dependencies (evidence: `src/Composer/Installer.php`)
- Dependency solver → Package model: evaluates packages
- Dependency solver → Platform packages: checks platform
- Version parsing → Platform packages: parses constraints (evidence: `src/Composer/Package/Version/VersionParser.php`)
- Repository manager → Package metadata: creates repository (evidence: `src/Composer/Repository/RepositoryManager.php`)
- Repository manager → Runtime context: uses context (evidence: `src/Composer/Repository/RepositoryManager.php`)
- Package metadata → Package model: loads package data (evidence: `src/Composer/Repository/ComposerRepository.php`)
- Package metadata → Package registry: fetches metadata
- VCS repositories → Package model: loads package data (evidence: `src/Composer/Repository/VcsRepository.php`)
- Install orchestration → Download manager: downloads packages (evidence: `src/Composer/Installer.php`)
- Install orchestration → Installation manager: applies operations (evidence: `src/Composer/Installer.php`)
- Installation manager → Download manager: downloads files (evidence: `src/Composer/Installer/InstallationManager.php`)
- Install orchestration → Autoload generation: generates autoload (evidence: `src/Composer/Installer.php`)
- Runtime context → Plugin manager: holds manager (evidence: `src/Composer/Plugin/PluginManager.php`)
- Plugin manager → Events and scripts: subscribes handlers (evidence: `src/Composer/Plugin/PluginManager.php`)
- Project commands → Package search: includes search (evidence: `src/Composer/Command/SearchCommand.php`)
- Package search → Package registry: searches packages
- Project commands → Advisory auditing: includes audit
- Project commands → Package archiving: includes archive
- Package archiving → Download manager: uses downloads (evidence: `src/Composer/Package/Archiver/ArchiveManager.php`)
