This template builds Magento 2 CE on Platform.sh. It includes additional scripts to customize Magento to run effectively in a build-and-deploy environment. A MariaDB database and Redis cache server come pre-configured and work out of the box. The installer has been modified to not ask for database information. Background workers are run using a worker container rather than via cron.
Magento is a fully integrated ecommerce system and web store written in PHP. This is the Open Source version.
- PHP 7.2
- MariaDB 10.2
- Redis 3.2
- Dedicated worker instance for background processing
- Automatic TLS certificates
- Composer-based build
- The site comes pre-configured with an admin account, with username/password of
admin/admin123. Login at/adminin your browser. You will be required to update the password the first time you log in.
The following changes have been made relative to Magento 2 as it is downloaded from Magento.com. If using this project as a reference for your own existing project, replicate the changes below to your project.
- The
.platform.app.yaml,.platform/services.yaml, and.platform/routes.yamlfiles have been added. These provide Platform.sh-specific configuration and are present in all projects on Platform.sh. You may customize them as you see fit. - An additional front controller is included in
pub/static-versioned.phpto serve static files. - A custom deploy script, written in Python, is provided in the
deployfile and called from the deploy hook in.platform.app.yaml. Thedeployscript handles installing Magento on first run, including populating the administrator account. It also handles Magento self-updates on normal point release updates. Do not modify or remove this file. - The installer has been patched to not ask for information that is already provided by Platform.sh, such as database credentials, file paths, or the initial administrator account. These changes should have no impact post-installation. See the patch file for details.
- An additional script has been added to force the cron process to not start background workers. See disable-cron-workers.php for details. It runs on deploy and modifies the
.config/env.phpfile. - A worker container is also created to handle background processing. That means that Magento cannot be run on a production plan smaller than Medium.
- A base Landofile provides configuration to use this template locally using Lando.
This template has been configured for use with Lando. Lando is Platform.sh's recommended local development tool. It is capable of reading your Platform.sh configuration files and standing up an environment that is very similar to your Platform.sh project. Additionally, Lando can easily pull down databases and file mounts from your Platform.sh project.
To get started using Lando with your Platform.sh project check out the Quick Start or the official Lando Platform.sh documentation.