lane4core/classversion

ClassVersion enables loading classes with the same name from specific subdirectories associated with respective version labels

1.0.0 2025-10-10 14:45 UTC

Requires

• php: >=8.1
• lane4core/contract: ^1.0

Requires (Dev)

• phpstan/phpstan: ^2.0.4
• phpunit/phpunit: ^10.5
• squizlabs/php_codesniffer: ^3.11.2

MIT

• Core Development

• loader
• versioning
• Domain Driven Design
• classversion
• version class loader
• lane4 digital
• lane4core

README

ClassVersion enables loading classes with the same name from specific subdirectories associated with respective version labels.

Description for example code

This code implements a dynamic loading system for classes, allowing different versions of a class to be loaded from corresponding subdirectories. The main functionality is provided by the ClassVersion and ClassVersionConfig classes. Here is a step-by-step explanation:

1. Class Version Configuration:
   • The $classVersions variable defines a mapping of subdirectories (subDirectory) to available version labels (version1, version2).
2. Configuration Initialization:
   • A ClassVersionConfig object is created and initialized with the version configuration $classVersions.
3. ClassVersion Instance:
   • An instance of ClassVersion is created, working with the previously defined configuration.
4. Loading Classes:
   • ClassVersion enables loading classes in different versions:

• $classVersion(YourClass::class): Loads the default version of the class YourClass.
• $classVersion(YourClass::class, 'version1'): Loads version version1 of the class YourClass.
• $classVersion(YourClass::class, 'version2'): Loads version version2 of the class YourClass.

Code Benefits

This approach allows different versions of a class to be dynamically loaded without directly referencing the implementations in the code. This is particularly useful in projects that require versioning, such as API versions or experimental implementations of classes.

Example Code

use lane4core\ClassVersion\ClassVersion;
use lane4core\ClassVersion\config\ClassVersionConfig;

$classVersions = ['subDirectory' => ['version1', 'version2']];
$classVersionConfig = new ClassVersionConfig($classVersions);
$classVersion = new ClassVersion($classVersionConfig);

$class = $classVersion(YourClass::class)
$class1 = $classVersion(YourClass::class, 'version1')
$class2 = $classVersion(YourClass::class, 'version2')

Quickstart Composer

composer require lane4core/classversion
make install

Quickstart GitHub

git clone https://github.com/lane4core/classversion.git
cd classversion

GitHub Repository Contents

• Source Files:
  • src
  • tests
• Support:
  • Docker Compose
  • .env
  • pre-commit-hook.sh
  • Makefile: Simply run make in the terminal.
• Documentation:
  • README.md