DocumentationCommerceConfiguration Guide

Base directory paths

Last update: Fri Nov 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Experienced
  • Admin
  • Developer

The MAGE_DIRS environment variable enables you to specify custom base directory paths and fragments of base URLs that are used by the Commerce application to build absolute paths to various files or for generating URLs.

Set MAGE_DIRS

Specify an associative array where keys are constants from \Magento\App\Filesystem\DirectoryList and values are absolute paths of directories or their URL paths, respectively.

You can set MAGE_DIRS in any of the following ways:

  • Set the value of bootstrap parameters

  • Use a custom entry point script such as the following:

    code language-php 
    <?php
/**
 * Copyright [first year code created] Adobe
 * All Rights Reserved.
 */

use Magento\Framework\App\Bootstrap;
use Magento\Framework\App\Filesystem\DirectoryList;
use Magento\Framework\App\Http;

require __DIR__ . '/app/bootstrap.php';
$params = $_SERVER;
$params[Bootstrap::INIT_PARAM_FILESYSTEM_DIR_PATHS] = [
     DirectoryList::PUB => [DirectoryList::URL_PATH => ''],
     DirectoryList::MEDIA => [DirectoryList::PATH => '/mnt/nfs/media', DirectoryList::URL_PATH => ''],
     DirectoryList::STATIC_VIEW => [DirectoryList::URL_PATH => 'static'],
     DirectoryList::UPLOAD => [DirectoryList::URL_PATH => '/mnt/nfs/media/upload'],
     DirectoryList::CACHE => [DirectoryList::PATH => '/mnt/nfs/cache'],
];
$bootstrap = Bootstrap::create(BP, $params);
/** @var Http $app */
$app = $bootstrap->createApplication(Http::class);
$bootstrap->run($app);

The preceding example sets paths for [cache] and [media] directories to /mnt/nfs/cache and /mnt/nfs/media, respectively.

recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c