elyerr/elyscope

PHP dependency isolation and namespace scoping tool.

Maintainers

Package info

github.com/elyerrlabs/elyscope

pkg:composer/elyerr/elyscope

Statistics

Installs: 23

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v1.0.2 2026-06-23 01:40 UTC

Requires

AGPL-3.0-or-later a88a2383ac29a171073b265b4512260da948ced3

This package is auto-updated.

Last update: 2026-06-23 01:43:48 UTC

README

PHP dependency isolation and namespace scoping tool for modular applications.

Elyscope is a core component of the ElyMod ecosystem and works alongside OAuth2 Passport Server to enable true application modularization in PHP.

Why Elyscope?

Traditional Composer projects share a single vendor directory. This becomes a problem when building modular systems because modules may:

  • Require different versions of the same package.
  • Introduce dependency conflicts.
  • Pollute the application's global namespace.
  • Break compatibility between modules.
  • Become difficult to distribute independently.

Elyscope solves these problems by creating isolated and scoped dependencies for each module.

Using PHP-Scoper and an automated Composer workflow, Elyscope generates a dedicated dependency layer that can coexist with the host application without namespace collisions.

What problems does it solve?

  • Dependency version conflicts.
  • Namespace collisions.
  • Vendor pollution.
  • Package compatibility issues.
  • Module portability limitations.
  • Shared dependency management problems.

ElyMod Ecosystem

Elyscope is an essential component of:

  • ElyMod
  • OAuth2 Passport Server

Together they provide the foundation required to build modular PHP and Laravel applications where each module can manage its own dependencies without affecting the host application.

Features

  • Dependency isolation using PHP-Scoper
  • Automatic namespace prefixing
  • Clean vendor backup management
  • Scoped vendor generation
  • Composer command passthrough
  • Automatic installed.json synchronization
  • Compatible with existing Composer workflows
  • Designed for modular PHP applications
  • Supports independent module distribution

Installation

Global Installation

Install ElyScope globally using Composer:

composer global require elyerr/elyscope

Verify the installation:

elyscope --help

Command Not Found?

If elyscope is not recognized, Composer's global bin directory may not be available in your system PATH.

Add Composer's global bin directory to your shell configuration:

echo 'export PATH="$PATH:$HOME/.composer/vendor/bin"' >> ~/.bashrc
source ~/.bashrc

If your system uses Composer's XDG directory structure, use:

echo 'export PATH="$PATH:$HOME/.config/composer/vendor/bin"' >> ~/.bashrc
source ~/.bashrc

You can check the exact Composer bin directory with:

composer global config bin-dir --absolute

Alternatively, run ElyScope using its full path:

$(composer global config bin-dir --absolute)/elyscope --help

Common Composer global bin locations include:

~/.composer/vendor/bin

or

~/.config/composer/vendor/bin

Add Composer Bin Directory to PATH

For a permanent solution, add Composer's global bin directory to your system PATH.

Example for Bash:

export PATH="$(composer global config bin-dir --absolute):$PATH"

Add the command above to your ~/.bashrc, ~/.zshrc, or shell configuration file.

Verify that the link works:

elyscope --help

Usage

Install dependencies

elyscope install

Workflow:

  1. Remove existing vendor directory
  2. Run Composer install
  3. Run PHP-Scoper
  4. Create vendor-packsave backup
  5. Replace vendor with scoped vendor-build
  6. Update installed.json metadata
  7. Generate optimized autoload files

Production install

elyscope install --no-dev

Update dependencies

elyscope update

Workflow:

  1. Restore vendor from vendor-packsave
  2. Run Composer update
  3. Refresh vendor-packsave
  4. Run PHP-Scoper
  5. Replace vendor with scoped vendor-build
  6. Update installed.json metadata
  7. Generate optimized autoload files

Production update

elyscope update --no-dev

Composer Passthrough

Commands not handled by Elyscope are automatically forwarded to Composer.

Examples:

elyscope require monolog/monolog
elyscope remove monolog/monolog
elyscope show
elyscope outdated
elyscope validate

Directory Structure

vendor/
vendor-packsave/
vendor-build/

vendor

Scoped dependencies used by the module.

vendor-packsave

Clean backup of the original Composer dependencies before scoping.

vendor-build

Temporary PHP-Scoper output directory.

Requirements

  • PHP 8.2+
  • Composer
  • PHP-Scoper

License

Copyright (C) 2026 Elvis Y. Roman C.

Licensed under the GNU Affero General Public License v3.0 or later.