PHPackages                             torq/shopwarecommon - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. torq/shopwarecommon

ActiveShopware-platform-plugin

torq/shopwarecommon
===================

torq/shopwarecommon

4.2.1(3mo ago)05.8k↓16.7%[2 PRs](https://github.com/TorqIT/shopware-common/pulls)1MITPHP

Since Dec 9Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/TorqIT/shopware-common)[ Packagist](https://packagist.org/packages/torq/shopwarecommon)[ RSS](/packages/torq-shopwarecommon/feed)WikiDiscussions v4.x Synced 1mo ago

READMEChangelog (10)Dependencies (3)Versions (82)Used By (1)

shopware-common
===============

[](#shopware-common)

This repository (plugin) provides a centralized location for commonly reused code across multiple Torq Shopware projects, ensuring a single point of truth for shared functionality and enabling easier maintenance.

---

Package Versions
----------------

[](#package-versions)

**Shopware 6.6.x** use branch v3.x

**Shopware 6.7.x** use branch v4.x

---

Adding a Submodule to an existing repository
--------------------------------------------

[](#adding-a-submodule-to-an-existing-repository)

Run the following command to create the shopwarecommon submodule in an existing Torq Showpare repo, then perform the steps in **Submodule Installation**.

`git submodule add -f https://github.com/TorqIT/shopware-common src/custom/plugins/TorqShopwareCommon`

Updating Submodule
------------------

[](#updating-submodule)

After cloning your Git repository for the first time, pull down the submodule code by executing the following commands.

```
git submodule init
git submodule update
```

> **Note**: This ensures the submodule is initialized and its content is fetched.

---

Submodule Installation
----------------------

[](#submodule-installation)

To install the submodule and set up the container, follow these steps:

1. **Build and start the container**:

    ```
    docker compose up --build
    ```
2. **Access the container**: Connect to the container as the **www-data** user by running:

    ```
    docker compose exec -it -u www-data php bash
    ```
3. **Install the `shopwarecommon` plugin**: Inside the container, add the **shopwarecommon** plugin to your Shopware project using Composer:

    ```
    composer require torq/shopwarecommon
    ```

> **Note**: The `composer require` command will add the **shopwarecommon** plugin as a dependency and update the `composer.json` and `composer.lock` files accordingly. It will also add the necessary files and folders to the **vendor** directory.

### Encryption

[](#encryption)

Presently we're using the `defuse/php-encryption` library for handling encryption, and our wrapper class is `TorqShopwareCommon/src/Security/Encryption/EncryptionHandler.php`.

In order to use this plugin successfully your project will need to have an environment variable called `TORQ_SHOPWARE_COMMON_ENCRYPTION_SECRET`. The value of this can be generated using the included key generation tool available inside of all PHP containers at `vendor/bin/generate-defuse-key`.

**YOU MUST FOLLOW THESE RULES WHEN MANAGING KEYS:**

1. NEVER PUT THE ENCRYPTION KEY DIRECTLY INSIDE THE CONFIG FILE
2. NEVER COMMIT AN ENCRYPTION KEY TO A REPOSITORY
3. NEVER USE THE SAME ENCRYPTION KEY IN DEV, TEST or PROD ENVIRONMENTS.

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance86

Actively maintained with recent releases

Popularity23

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 50.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~8 days

Recently: every ~17 days

Total

57

Last Release

59d ago

Major Versions

1.7.0 → 2.1.02025-02-28

2.9.0 → 3.0.02025-04-15

3.8.3 → 4.0.02025-10-16

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/58705850?v=4)[TORQ](/maintainers/TorqIT)[@TorqIT](https://github.com/TorqIT)

---

Top Contributors

[![akingtorq](https://avatars.githubusercontent.com/u/162343033?v=4)](https://github.com/akingtorq "akingtorq (92 commits)")[![jeremygnoonan](https://avatars.githubusercontent.com/u/33028237?v=4)](https://github.com/jeremygnoonan "jeremygnoonan (71 commits)")[![evanjamesjackson](https://avatars.githubusercontent.com/u/5866481?v=4)](https://github.com/evanjamesjackson "evanjamesjackson (15 commits)")[![ColinPoushay](https://avatars.githubusercontent.com/u/185804448?v=4)](https://github.com/ColinPoushay "ColinPoushay (1 commits)")[![dtr-torqit](https://avatars.githubusercontent.com/u/190630818?v=4)](https://github.com/dtr-torqit "dtr-torqit (1 commits)")[![elirdelshani](https://avatars.githubusercontent.com/u/195334850?v=4)](https://github.com/elirdelshani "elirdelshani (1 commits)")

### Embed Badge

![Health badge](/badges/torq-shopwarecommon/health.svg)

```
[![Health](https://phpackages.com/badges/torq-shopwarecommon/health.svg)](https://phpackages.com/packages/torq-shopwarecommon)
```

###  Alternatives

[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[shopware/storefront

Storefront for Shopware

684.2M148](/packages/shopware-storefront)[shopware/administration

Administration frontend for the Shopware Core

413.9M75](/packages/shopware-administration)[api-platform/state

API Platform state interfaces

223.4M57](/packages/api-platform-state)[api-platform/validator

API Platform validator component

223.2M10](/packages/api-platform-validator)[open-dxp/opendxp

Content &amp; Product Management Framework (CMS/PIM)

7310.3k29](/packages/open-dxp-opendxp)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
