Adding Composer dependencies
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
composer.json fileIn 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
autoload.phpThe
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
private LoggerInterface $logger;
14
​
15
public function __construct(
16
LoggerInterface $logger
17
) {
18
$this->logger = $logger;
19
}
20
​
21
public static function getSubscribedEvents(): array
22
{
23
// Return the events to listen to as array like this: <event to listen to> => <method to execute>
24
return [
25
NavigationPageLoadedEvent::class => 'onNavigationPage'
26
];
27
}
28
​
29
public function onNavigationPage(NavigationPageLoadedEvent $event)
30
{
31
$exporter = new Exporter;
32
$this->logger->info($exporter->export('hello, world!'));
33
}
34
}
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
Last modified 5mo ago