Shopware PHP Extension

A high-performance PHP extension written in Rust, providing bindings for:

• QuickJS - Fast JavaScript engine for executing JS from PHP
• LightningCSS - Fast CSS parser, transformer, and minifier

Requirements

• PHP 8.1+

• Rust (latest stable)

• System dependencies:

  • pkg-config

macOS

brew install pkg-config

Ubuntu/Debian

sudo apt-get install pkg-config

Building

# Install dependencies
composer install

# Build release version
make build

# Build debug version
make build-debug

Running Tests

# Run tests with release build
make test

# Run tests with debug build
make test-debug

Running Benchmarks

make bench

PHP Classes

QuickJS - JavaScript Engine

Execute JavaScript code from PHP with full bidirectional data exchange.

use Shopware\PHPExtension\QuickJS\QuickJS;
use Shopware\PHPExtension\QuickJS\QuickObject;

$js = new QuickJS();

// Evaluate JavaScript code
$result = $js->eval('1 + 2'); // Returns: 3

// Set global variables
$js->setGlobal('name', 'World');
$js->setGlobal('config', ['debug' => true, 'version' => '1.0.0']);
echo $js->eval("'Hello, ' + name"); // Returns: "Hello, World"

// Get global variables
$js->eval("var counter = 42");
$value = $js->getGlobal('counter'); // Returns: 42

// Check if global exists
$js->hasGlobal('counter'); // Returns: true

// Get type of global
$js->typeofGlobal('counter'); // Returns: "number"

// Call JavaScript functions
$js->eval("function greet(name) { return 'Hello, ' + name + '!'; }");
$result = $js->call('greet', ['World']); // Returns: "Hello, World!"

// Register PHP functions for use in JavaScript
$js->registerFunction('upper', 'strtoupper');
$js->registerFunction('md5', 'md5');
echo $js->eval("upper('hello')"); // Returns: "HELLO"

// Create JavaScript objects with QuickObject
$obj = new QuickObject();
$obj->registerProperty('version', '1.0.0');
$obj->registerProperty('debug', true);
$obj->registerFunction('hash', 'md5');

$js->registerObject('App', $obj);
echo $js->eval("App.version"); // Returns: "1.0.0"
echo $js->eval("App.hash('test')"); // Returns: md5 hash

// Nested objects
$db = new QuickObject();
$db->registerProperty('host', 'localhost');
$db->registerProperty('port', 3306);

$config = new QuickObject();
$config->registerProperty('name', 'MyApp');
$config->registerObject('database', $db);

$js->registerObject('Config', $config);
echo $js->eval("Config.database.host"); // Returns: "localhost"

// Memory management
$js->setMemoryLimit(10 * 1024 * 1024); // 10MB limit
$js->setMaxStackSize(1024 * 1024); // 1MB stack
$js->gc(); // Run garbage collection
$usage = $js->memoryUsage(); // Get memory usage in bytes

LightningCSS - CSS Processing

Fast CSS parsing, minification, and transformation.

use Shopware\PHPExtension\LightningCSS\LightningCSS;

$css = new LightningCSS();

// Minify CSS
$minified = $css->minify('body { color: red; }');
// Returns: "body{color:red}"

// Format/pretty-print CSS
$formatted = $css->format('body{color:red}');
// Returns formatted CSS with newlines

// Validate CSS syntax
$isValid = $css->validate('body { color: red; }'); // Returns: true

// Analyze CSS
$info = $css->analyze('body { color: red; } .test { margin: 10px; }');
// Returns: ['rules_count' => 2]

// Set browser targets for compatibility
$css->setBrowserTargets([
    'chrome' => 95,
    'firefox' => 90,
    'safari' => 14,
    'edge' => 95,
    'ie' => 11,
    'opera' => 80,
    'ios_safari' => 14,
    'android' => 95,
    'samsung' => 15,
]);

// Transform CSS with vendor prefixes for older browsers
$transformed = $css->transform('.test { user-select: none; }');

License

MIT