Adding Composer dependencies

Installation Extensions API Reference Feedback 📣
Search…
In this guide you'll learn how to add Composer dependencies to your project.
Prerequisites
All you need for this guide is a running Shopware 6 instance and full access to both the files and a running plugin. Of course you'll have to understand PHP, but that's a prerequisite for Shopware as a whole and will not be taught as part of this documentation. Further a basic understanding Node and NPM is required.
Adding a composer plugin to the composer.json file
In this guide we will install exporter, which provides the functionality to export PHP variables for visualization.
We have to manually remove all of the references to Shopware itself from the composer.json file, that was created in the Plugin base guide, before we add our own dependencies to it. This is done to prevent composer from downloading Shopware into the vendor folder.
Now we can simply install exporter by running composer require sebastian/exporter in your plugin directory.
After that we have to add our dependency to shopware back in.
The vendor directory, where the composer saves the dependencies, has to be included in the plugin bundle. The plugin bundle size is not allowed to exceed 5 MB.
Loading the autoload.php
The composer require command created the autoload.php that we now need to require in our plugin.
<plugin root>/src/SwagBasicExample.php
1
if (file_exists(dirname(__DIR__) . '/vendor/autoload.php')) {
2
    require_once dirname(__DIR__) . '/vendor/autoload.php';
3
}
Copied!
Using the composer plugin
PHP doesn't require a build system, which means that we can just add use statements and then use the composer dependency directly.
The following code sample imports SebastianBergmann\Exporter\Exporter and logs hello, world! to the Symfony profiler logs whenever the NavigationPageLoadedEvent is fired. Learn how to register this listener here.
<plugin root>/src/SwagBasicExample.php
1
<?php
2
namespace SwagBasicExample\Subscriber;
3
​
4
use Shopware\Core\Framework\DataAbstractionLayer\Event\EntityLoadedEvent;
5
use Symfony\Component\EventDispatcher\EventSubscriberInterface;
6
use Shopware\Storefront\Page\Navigation\NavigationPageLoadedEvent;
7
​
8
use Psr\Log\LoggerInterface;
9
use SebastianBergmann\Exporter\Exporter;
10
​
11
class MySubscriber implements EventSubscriberInterface
12
{
13
    /**
14
     * @var LoggerInterface
15
     */
16
     private $logger;
17
​
18
    public function __construct(
19
        LoggerInterface $logger
20
    ) {
21
        $this->logger = $logger;
22
    }
23
​
24
    public static function getSubscribedEvents(): array
25
    {
26
        // Return the events to listen to as array like this:  <event to listen to> => <method to execute>
27
        return [
28
            NavigationPageLoadedEvent::class => 'onNavigationPage'
29
        ];
30
    }
31
​
32
    public function onNavigationPage(NavigationPageLoadedEvent $event)
33
    {
34
        $exporter = new Exporter;
35
        $this->logger->info($exporter->export('hello, world!'));
36
    }
37
}
Copied!
Adding private composer dependencies
You can bundle composer dependencies with your plugin by adding them to the /packages/ folder of your plugin.
Example structure:
1
SwagBasicExample
2
├── packages
3
│   └── my-private-dependency/
4
│       ├── composer.json
5
│       └── src/
6
│           └── SomeCoolService.php
7
├── src/
8
│   └── SwagBasicExample.php
9
└── composer.json
Copied!
You can then require them like other dependencies:
1
"require": {
2
    "my-vendor-name/my-private-dependency": "^1.2.3",
3
}
Copied!
More interesting topics
​Using NPM dependencies​
​Adding plugin dependencies​
Adding NPM dependencies
Plugin lifecycle methods
Last modified 6mo ago
Copy link
Contents
Prerequisites
Adding a composer plugin to the composer.json file
Loading the autoload.php
Using the composer plugin
Adding private composer dependencies