(Draft - This Content is still being built, if you have feedback, requests or general feedback please send a mail to firstname.lastname@example.org.
We look forward to hearing from you!
Welcome to the Spryker Commerce OS getting started guide.
We structured this page to be a step-by-step checklist that you will be able to follow you through all the stages of working with Spryker.
In this step, you will install Spryker, choose the option that is most suitable for you:
- Install the Shop App: This will install the Spryker Commerce OS VM, fully loaded with a Shop App boilerplate.
- Install the Shop App: no VM – This will guide you on how to install the Spryker Commerce OS without the VM (why do we provide this option? What is the benefit of this and the VM?
- Install the Shop App on Windows: This installation uses Docker to install a, fully functional non-production version of the Spryker Commerce OS.
Once you have completed the installation you should familiarize yourself with the modules.
A comprehensive guide to what modules are including, atomic releases and semantic versioning.
How we use composer to manage dependencies and add, update, delete and replace modules.
- Adding, removing and updating packages – along with specific command-line examples
In this step we will cover all the different tasks you need to perform to hook up and configure your Spryker Commerce OS installation and customize it for your environment.
- Spryker config:
What is Spryker config, where is it located and how do we use it?
- Configuring your environment:
Database, Redis, ElasticSearch and Queue.
- Store Configuration
- Scheduling Tasks (Cron Jobs)
- Moving to Maintenance Mode
As a developer, the Spryker directory structure is the first thing that you need to know in order to extend core functionality. In this step we will help you familiarize yourself with the different parts of the directory the Client, Shared, Zed and Yves folders and their different layers.
- Introduction to navigating the folder structure, main concepts and namespacing.
- The project directory
- The OS directories
Get to know the parts of the Spryker Development Virtual Machine with which we ship the Spryker Commerce OS so that you have a pre-configured and ready to go stack.
- What is the Spryker DevVM (Development Virtual Machine) and why do we need it?
- Main Structure
- Technology Stack: Linux distribution, PHP, Postgres, MySQL, ES, Redis, Queue, Jenkins
Before taking the next step into working with the code, setup and get to know your debugging environment.
- What is the debugging environment?
- Debugging with PHPStorm
- Setting up XDEBUG
Where to from here?
To better understand the Spryker Commerce OS, the next step is to visit our Architecture Overview. If you are familiar with our architecture, try on of these other resources:
- The development guide where you will find API documentation and instructions describing how to extend Spryker Capabilities.
- The module guide for an overview of each module and previous versions
- Tooling guide, how to test code quality, monitoring, logging, deployment and hosting
- Ecosystem Guide for information about our third party technology partners and how to integrate with them.
- Advanced development concepts - a deeper look into the Spryker Commerce OS architecture, naming and design concepts
- Check out our howtos and tutorials
To navigate through content, click on an option from the right-hand table of contents or use the search (above).
You can also use navigation buttons on the top right corner of page:
- Navigate previous button takes you the page preceding the one you are currently on.
- Navigate next button takes you to the page that goes next after the page you are currently on.
- To improve readability, all long code samples and texts have been placed in collapsible areas. Use the Expand all button to expand and collapse long text and code samples or click on a single item to view.
- To print a page, click Print button.
- Use Edit on GitHub button to ask a question regarding the page content or request a change to it.