Skip to content
No description, website, or topics provided.
Branch: develop
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
src/AppBundle fix(Checkout): fix checkout and cart issues with anonymous session Dec 14, 2018
tests Update dependencies & fix config (#32) Jul 13, 2018
web Merge branch 'develop' into feature-yl-myaccount_personal_details Apr 14, 2016
.sensiolabs.yml refactor(Config): typo Feb 10, 2016
.travis.yml chore(Github): transfer ownership to commercetools organization Oct 24, 2016
LICENSE Initial commit Aug 12, 2015
Procfile Update Jul 13, 2018
app.json Update app.json Jul 14, 2018
behat.yml chore(Behat): fix config for saucelabs May 18, 2016
docker-compose.yml chore(Docker): add docker-compose configuration Apr 13, 2016
nginx_app.conf chore(Heroku): fix nginx config Feb 12, 2016
package.json test(Travis): fix typo in remote ui tests Nov 10, 2016
phpunit.xml.dist add local sbt Aug 27, 2015
yarn.lock test(UI): move from npm to yarn install Nov 10, 2016


SUNRISE PHP is a template shopfront implementation that implements a complete online shop on the commercetools eCommerce platform using the following components:

It aims to focus on being slim, easy to understand and fast, delegating reusabilty into the commons and symfony-components libraries.

Please read the Changelog before updating in any case.


  • PHP (see the SDK for detailed requirements)
  • composer


To run, you need a project on the commercetools platform that contains some minimum necessary content (e.g. the sample data). Then get your project key, client ID and client secret from the merchant center and provide them in one of the following ways:

  1. create a file app/config/parameters.yml with the following format:
    secret: <your application secret>
    commercetools.client_id: <your client id>
    commercetools.client_secret: <your client secret>
    commercetools.project: <your project key>

For local development purposes you can run the application in the php built-in web server. The web folder contains static assets and index.php as the only PHP file.

Production Site:

php bin/console server:run --env prod

Development Site:

php bin/console server:run

Open http://localhost:8000/


To improve the template, we are happily receiving pull requests with improvements and bug fixes. If you'd like to change bigger things or add features it's a good idea to discuss the idea in a github issue first.

IMPORTANT: The composer configuration clones the PHP commons library and the sunrise designs inside the vendor directory. So pay attention when doing git operations with changes in these files.

Using the command line

Available console commands

php bin/console list

Cache warm up

php bin/console cache:warmup



For an easy and fast deployment of your application we recommend heroku:



The Sunrise app is delivered with a docker compose configuration.

docker run -v $PWD:/var/www/symfony -w /var/www/symfony --rm=true jaysde/symfony-php-fpm composer install --prefer-dist
docker-compose up

This starts a nginx and a php-fpm docker container serving the application.

Create your own shop

Fork and forge your own eCommerce solution from it.

More specifically:

  • fork the project or just copy the code (the MIT license of this code and the SUNRISE design allow unrestricted commercial use and modification)
  • you may want to change the namespace of some things to your own project's name (TODO the template could use a generic namespace from the beginning)
  • EITHER override and change the SUNRISE design by creating a templates directory in the project folder and overriding the *.hbs filenames you find in vendor/commercetools/sunrise-design/templates
  • OR create an own HTML and templates structure from scratch using your preferred tools and template language
  • add and change stuff as you like
  • Be nice and contribute useful generic helpers back to the OSS commons library.
You can’t perform that action at this time.