README

PHP Method Overrider

⚠️ Experimental Package - This is a work in progress and not intended for production use.

Dynamically override specific methods of any PHP class at runtime while preserving method signatures and providing access to the original implementation.

Installation

composer require christophrumpel/method-overrider

Usage

use ChristophRumpel\MethodOverrider\MethodOverrider;

class MathService
{
    public function add(int $a, int $b): int
    {
        return $a + $b;
    }
}

$overrider = new MethodOverrider();

// Override the add method to multiply instead
$instance = $overrider->override(
    class: MathService::class,
    methodNames: 'add',
    implementations: function (callable $original, int $a, int $b): int {
        // You can still call the original method
        $originalResult = $original();

        // Or implement completely new logic
        return $a * $b;
    }
);

echo $instance->add(2, 3); // Output: 6 (multiplied instead of added)

How it works

The package uses reflection to analyze method signatures and dynamically generates new classes that extend your original class. The overridden methods wrap your custom implementations while providing access to the original method via a closure.

Note: The override() method uses eval() to dynamically create and instantiate the overridden class. If you prefer to avoid eval(), see the alternative method below.

Alternative: Generate Class Without eval()

If you want to avoid eval(), you can use the generateOverriddenClass() method which returns the generated class code as a string along with metadata:

$result = $overrider->generateOverriddenClass(
    class: MathService::class,
    methodNames: 'add',
    implementations: function (callable $original, int $a, int $b): int {
        return $a * $b;
    }
);

// Returns an array with:
// - 'content': The generated PHP class code as a string
// - 'implementations': The provided implementations array
// - 'className': The generated class name

// You can then save this to a file or handle it however you prefer
file_put_contents('path/to/MathServiceCacheProxy.php', $result['content']);

Requirements

• PHP 8.3+