Deployment flow
The Commerce production deployment flow helps a store reach maximum performance.
Install dependencies
The composer.json
and composer.lock
files manage Commerce dependencies and install the appropriate version for each package. You must install dependencies before preprocessing dependency injection instructions if you plan to update the autoloader.
To install Commerce dependencies:
composer install --no-dev
Preprocess dependency injection instructions
When you preprocess and compile dependency injection (DI) instructions, Magento:
- Reads and processes all present configuration
- Analyzes dependencies between classes
- Creates autogenerated files (including proxies, factories, etc.)
- Stores compiled data and configuration in a cache that saves up to 25% of time on requests processing
To preprocess and compile DI instructions:
bin/magento setup:di:compile
Update the autoloader
After compilation completes, confirm that APCu is enabled and update the autoloader:
To update the autoloader:
-o
option converts PSR-0/4 autoloading to classmap to get a faster autoloader. The --apcu
option uses APCu to cache found/not-found classes.composer dump-autoload -o --apcu
If you plan on updating the autoloader, you must run the following commands in order:
composer install --no-dev
bin/magento setup:di:compile
composer dump-autoload -o
bin/magento setup:static-content:deploy
Deploy static content
Deploying static content causes Commerce to perform the following actions:
- Analyze all static resources
- Perform merge, minimization, and bundling of content
- Read and process theme data
- Analyze theme fallback
- Store all processed and materialized content to specific folder for further usage
If your static content is not deployed, Commerce performs all listed operation on the fly, leading to a significant increase in response time.
You can use a variety of options to customize deployment operations based on store size and fulfillment needs. The most common is the compact deploy strategy. See Static files deployment strategies
To deploy static content:
bin/magento setup:static-content:deploy
This command allows Composer to rebuild the mapping to project files so that they load faster.
Set production mode
setup:di:compile
and setup:static-content:deploy
.Finally, you need to place your store in Production mode. Production mode is specifically optimized for maximum performance of your store. It also de-activates all developer-specific features. This can be done in your .htaccess
or nginx.conf
file:
SetEnv MAGE_MODE production
You can also deploy static content, compile the content, and set the mode in one CLI command:
bin/magento deploy:mode:set production
The command runs in the background and does not allow you to set additional options on each specific step.
Additional pre-launch actions
These steps are recommended, but are not mandatory. You can perform them immediately before launching your store in production mode. The list includes:
- Re-index data to avoid the presence of any inconsistent data in your indexes.
- Flush the cache to be sure no old or incorrect data are left in cache.
- Warm up the cache, which calls out the most popular or critical store pages in advance, so the cache for them is generated and stored. This operation can be performed with any internet crawler or manually, if you have a small store.