<?php use Okapi\CodeTransformer\CodeTransformerKernel; // Extend from the "CodeTransformerKernel" class class Kernel extends CodeTransformerKernel { // Define a list of transformer classes protected array $transformers = [ StringTransformer::class, UnPrivateTransformer::class, ]; // Define the settings of the kernel from the "protected" properties // The directory where the transformed source code will be stored protected ?string $cacheDir = __DIR__ . '/var/cache'; // The cache file mode protected ?int $cacheFileMode = 0777; }

// String Transformer <?php use Okapi\CodeTransformer\Transformer; use Okapi\CodeTransformer\Transformer\Code; // Extend from the "Transformer" class class StringTransformer extends Transformer { // Define the target class(es) public function getTargetClass(): string|array { // You can specify a single class or an array of classes // You can also use wildcards, see https://github.com/okapi-web/php-wildcards return MyTargetClass::class; } // The "transform" method will be called when the target class is loaded // Here you can modify the source code of the target class(es) public function transform(Code $code): void { // I recommend using the Microsoft\PhpParser library to parse the source // code. It's already included in the dependencies of this package and // the "$code->getSourceFileNode()" property contains the parsed source code. // But you can also use any other library or manually parse the source // code with basic PHP string functions and "$code->getOriginalSource()" $sourceFileNode = $code->getSourceFileNode(); // Iterate over all nodes foreach ($sourceFileNode->getDescendantNodes() as $node) { // Find 'Hello World!' string if ($node instanceof StringLiteral && $node->getStringContentsText() === 'Hello World!' ) { // Replace it with 'Hello from Code Transformer!' // Edit method accepts a Token or Node class $code->edit( $node->children, "'Hello from Code Transformer!'", ); // You can also manually edit the source code $code->editAt( $node->getStartPosition() + 1, $node->getWidth() - 2, "Hello from Code Transformer!", ); // Append a new line of code $code->append('$iAmAppended = true;'); } } } }

// UnPrivate Transformer <?php namespace Okapi\CodeTransformer\Tests\Stubs\Transformer; use Microsoft\PhpParser\TokenKind; use Okapi\CodeTransformer\Transformer; use Okapi\CodeTransformer\Transformer\Code; // Replace all "private" keywords with "public" class UnPrivateTransformer extends Transformer { public function getTargetClass(): string|array { return MyTargetClass::class; } public function transform(Code $code): void { $sourceFileNode = $code->getSourceFileNode(); // Iterate over all tokens foreach ($sourceFileNode->getDescendantTokens() as $token) { // Find "private" keyword if ($token->kind === TokenKind::PrivateKeyword) { // Replace it with "public" $code->edit($token, 'public'); } } } }

<?php class MyTargetClass { private string $myPrivateProperty = "You can't get me!"; private function myPrivateMethod(): void { echo 'Hello World!'; } }

// Initialize the kernel early in the application lifecycle // Preferably after the autoloader is registered <?php use MyKernel; require_once __DIR__ . '/vendor/autoload.php'; // Initialize the Code Transformer Kernel $kernel = MyKernel::init();

<?php class MyTargetClass { public string $myPrivateProperty = "You can't get me!"; public function myPrivateMethod(): void { echo 'Hello from Code Transformer!'; } } $iAmAppended = true;

<?php // Just use your classes as usual $myTargetClass = new MyTargetClass(); $myTargetClass->myPrivateProperty; // You can't get me! $myTargetClass->myPrivateMethod(); // Hello from Code Transformer!