PHPackages                             shopware/composer-project - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. shopware/composer-project

ActiveProject[Utility &amp; Helpers](/categories/utility)

shopware/composer-project
=========================

Project template for Shopware projects with composer

5.7.x-dev(2y ago)6925.0k40MITPHPPHP ^7.4 || ^8.0

Since Feb 2Pushed 2y ago39 watchersCompare

[ Source](https://github.com/shopware5/composer-project)[ Packagist](https://packagist.org/packages/shopware/composer-project)[ RSS](/packages/shopware-composer-project/feed)WikiDiscussions 5.7 Synced 1mo ago

READMEChangelogDependencies (4)Versions (3)Used By (0)

Composer template for Shopware projects
=======================================

[](#composer-template-for-shopware-projects)

Starting with v5.4 Shopware supports installation using composer out of the box. Earlier versions of Shopware are not supported.

Installation
------------

[](#installation)

```
composer create-project shopware/composer-project my_project_name --no-interaction --stability=dev
```

This will clone the repository with all necessary dependencies into a new directory `my_project_name`. You can then either remove the history of this project by deleting the `.git` directory and start from scratch by executing `git init .`, or keep the history and just add your own remote to push to.

Afterwards you either provide a `.env` file for defining database credentials, the shop-url and Shopware version or have one created for you using an interactive installer.

To use the installer, simply run:

```
$ ./app/bin/install.sh
```

Configuration
-------------

[](#configuration)

Configuration settings like environment specific database settings, API tokens, server IPs or any type of credentials should be set via environment variables. That way you don't have to include any environment specific or sensitive information in your project. You can use a `.env` file for local development or as a workaround.

You can also configure some generic project services in `app/services.xml`. For instance, the error log is configured to use `stderr` output instead of default log file located at `var/log` directory. New and additional services should be provided using plugins, though.

Updating Shopware
-----------------

[](#updating-shopware)

Update the version number of `shopware/shopware` in `composer.json`. Then run `composer update shopware/shopware`to install the new version. Do not forget to commit the new `composer.lock` file to your project afterwards.

### Prepare plugins for composer installation

[](#prepare-plugins-for-composer-installation)

Given you have a plugin called `SwagMediaSftp` add your dependencies in your plugins `composer.json` file. Also set the `type` to `shopware-plugin`. See the [SwagMediaSftp](https://github.com/shopwareLabs/SwagMediaSftp)repository for the complete plugin.

```
{
    "name": "shopwarelabs/swag-media-sftp",
    "type": "shopware-plugin",
    "description": "The SFTP adapter allows you to manage your media files in shopware on a SFTP environment.",
    "license": "MIT",
    "extra": {
        "installer-name": "SwagMediaSftp"
    },
    "require": {
        "league/flysystem-sftp": "^1.0"
    }
}
```

For a complete list of the available Shopware-related types see the [Composer Installers](https://github.com/composer/installers) repository.

Plugins
-------

[](#plugins)

Plugins being installed like described above are installed into `custom/plugins/`, legacy Shopware plugins are getting installed into `Plugins/`. Those directories are included in the `.gitignore` of this repo so plugins installed via composer are not being tracked by git.

In case you need some project specific plugins that you don't want to add to your project via composer but track them using this repository, then you can add them to the `custom/project` directory. Only plugins using the new plugin style are supported.

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity40

Moderate usage in the ecosystem

Community34

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~452 days

Total

3

Last Release

1026d ago

PHP version history (3 changes)5.5.x-devPHP ^7.0

5.6.x-devPHP ^7.2

5.7.x-devPHP ^7.4 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/7c45ef9077b73fce78afbfab2fa27e611a453dd77de003e2785ac84105d02bef?d=identicon)[shyim](/maintainers/shyim)

![](https://www.gravatar.com/avatar/66e9bb4e4fc1010046161b16bce3526aaac9a4208791a3f6fe15b236ed363a5f?d=identicon)[shopwareBot](/maintainers/shopwareBot)

![](https://www.gravatar.com/avatar/87bec78135aee2ab0f6ca5c7a0aae17966d8bfec3f873a81932fa65cf6621a20?d=identicon)[janbuecker](/maintainers/janbuecker)

![](https://www.gravatar.com/avatar/d5473cc0e8644ce724c74a1aa0f3ef29278218d14ea7d61f8a2d662ffeeaae89?d=identicon)[mitelg](/maintainers/mitelg)

---

Top Contributors

[![soebbing](https://avatars.githubusercontent.com/u/174161?v=4)](https://github.com/soebbing "soebbing (86 commits)")[![shyim](https://avatars.githubusercontent.com/u/6224096?v=4)](https://github.com/shyim "shyim (22 commits)")[![mitelg](https://avatars.githubusercontent.com/u/6985627?v=4)](https://github.com/mitelg "mitelg (18 commits)")[![jkrzefski](https://avatars.githubusercontent.com/u/11394739?v=4)](https://github.com/jkrzefski "jkrzefski (8 commits)")[![teiling88](https://avatars.githubusercontent.com/u/4624237?v=4)](https://github.com/teiling88 "teiling88 (5 commits)")[![hranicka](https://avatars.githubusercontent.com/u/3034538?v=4)](https://github.com/hranicka "hranicka (4 commits)")[![philipreinken](https://avatars.githubusercontent.com/u/16081565?v=4)](https://github.com/philipreinken "philipreinken (3 commits)")[![taltholtmann](https://avatars.githubusercontent.com/u/20816234?v=4)](https://github.com/taltholtmann "taltholtmann (3 commits)")[![larsbo](https://avatars.githubusercontent.com/u/754074?v=4)](https://github.com/larsbo "larsbo (3 commits)")[![fionera](https://avatars.githubusercontent.com/u/5741401?v=4)](https://github.com/fionera "fionera (2 commits)")[![avdv](https://avatars.githubusercontent.com/u/3471749?v=4)](https://github.com/avdv "avdv (2 commits)")[![janbuecker](https://avatars.githubusercontent.com/u/736986?v=4)](https://github.com/janbuecker "janbuecker (2 commits)")[![lx-wnk](https://avatars.githubusercontent.com/u/20777072?v=4)](https://github.com/lx-wnk "lx-wnk (2 commits)")[![nlubisch](https://avatars.githubusercontent.com/u/3511228?v=4)](https://github.com/nlubisch "nlubisch (2 commits)")[![wolv-dev](https://avatars.githubusercontent.com/u/4964718?v=4)](https://github.com/wolv-dev "wolv-dev (1 commits)")[![bcremer](https://avatars.githubusercontent.com/u/55820?v=4)](https://github.com/bcremer "bcremer (1 commits)")[![carstendietrich](https://avatars.githubusercontent.com/u/3203968?v=4)](https://github.com/carstendietrich "carstendietrich (1 commits)")[![Dwza](https://avatars.githubusercontent.com/u/3532688?v=4)](https://github.com/Dwza "Dwza (1 commits)")[![hlohaus](https://avatars.githubusercontent.com/u/983577?v=4)](https://github.com/hlohaus "hlohaus (1 commits)")[![mmayer-pt](https://avatars.githubusercontent.com/u/77410458?v=4)](https://github.com/mmayer-pt "mmayer-pt (1 commits)")

---

Tags

composer-projectecommerceecommerce-platformhacktoberfestphpshopware

### Embed Badge

![Health badge](/badges/shopware-composer-project/health.svg)

```
[![Health](https://phpackages.com/badges/shopware-composer-project/health.svg)](https://phpackages.com/packages/shopware-composer-project)
```

###  Alternatives

[roots/bedrock

WordPress boilerplate with Composer, easier configuration, and an improved folder structure

6.5k441.8k2](/packages/roots-bedrock)[pocketmine/pocketmine-mp

A server software for Minecraft: Bedrock Edition written in PHP

3.5k74.6k86](/packages/pocketmine-pocketmine-mp)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

728272.9k20](/packages/civicrm-civicrm-core)[flow-php/etl

PHP ETL - Extract Transform Load - Abstraction

374468.4k51](/packages/flow-php-etl)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)[rainlab/blog-plugin

Blog plugin for October CMS

17257.7k](/packages/rainlab-blog-plugin)

PHPackages © 2026

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