Переопределите каталог файлов окружения (DotEnv)

По умолчанию, файл конфигурации .env находится в корневом каталоге проекта. Если вы храните его в другом месте, определите опцию runtime.dotenv_path в файле composer.json:

1
2
3
4
5
6
7
8
9

{
    "...": "...",
    "extra": {
        "...": "...",
        "runtime": {
            "dotenv_path": "my/custom/path/to/.env"
        }
    }
}

Затем, обновите ваши файлы Composer (выполнив composer update, к примеру), чтобы файлы vendor/autoload_runtime.php были повторно сгенерированы с новым путем .env.

Вы также можете настроить разные пути .env для ваших вызовов консоли и веб-сервера. Отредактируйте файлы public/index.php и/или bin/console, чтобы определить новый путь файла.

Скрипт консоли:

1
2
3
4
5
6
7

// bin/console

// ...
$_SERVER['APP_RUNTIME_OPTIONS']['dotenv_path'] = 'some/custom/path/to/.env';

require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
// ...

Веб фронт-контроллер:

1
2
3
4
5
6
7

// public/index.php

// ...
$_SERVER['APP_RUNTIME_OPTIONS']['dotenv_path'] = 'another/custom/path/to/.env';

require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
// ...

Переопределите каталог конфигурации

Каталог конфигурациия - единственный не подддается переопределению в приложении Symfony. Его местоположение жестко закодировано в виде каталога config/ в корневом каталоге кашего приложения.

Переопределите каталог кеша

Вы можете изменить каталог кеша по умолчанию, переопределив метод getCacheDir() в классе Kernel вашего приложения:

1
2
3
4
5
6
7
8
9
10
11
12

// src/Kernel.php

// ...
class Kernel extends BaseKernel
{
    // ...

    public function getCacheDir(): string
    {
        return dirname(__DIR__).'/var/'.$this->environment.'/cache';
    }
}

В этом коде, $this->environment - это текущее окружение (т.е. dev). В этом случае, вы изменили локацию каталога кеша на var/{environment}/cache.

Вы также можете изменить каталог кеша, определяющего переменную окружения под названиемAPP_CACHE_DIR, чье значение является полным путем папки кеша.

Переопределите каталог логов

Переопределение каталога var/log/ почти то же самое, что и переопределение каталога var/cache/.

Вы можете сделать это, переопределив метод getLogDir() в классе Kernel вашего приложения:

1
2
3
4
5
6
7
8
9
10
11
12

// src/Kernel.php

// ...
class Kernel extends BaseKernel
{
    // ...

    public function getLogDir(): string
    {
        return dirname(__DIR__).'/var/'.$this->environment.'/log';
    }
}

Здесь вы изменили локацию каталога на var/{environment}/log/.

Вы также можете изменить каталог логов, определяющий переменную окружения под названием APP_LOG_DIR, чье значение является полным путем папки логов.

Переопределите каталог шаблонов

Если ваши щаблоны не хранятся в каталоге по умолчанию templates/, используйте опцию конфигурации twig.default_path , чтобы определить ваш собственный каталог шаблонов (используйте twig.paths для нескольких каталогов):

1
2
3
4

# config/packages/twig.yaml
twig:
    # ...
    default_path: "%kernel.project_dir%/resources/views"

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

<!-- config/packages/twig.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<container xmlns="http://symfony.com/schema/dic/services"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:twig="http://symfony.com/schema/dic/twig"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/twig
        https://symfony.com/schema/dic/twig/twig-1.0.xsd">

    <twig:config>
        <twig:default-path>%kernel.project_dir%/resources/views</twig:default-path>
    </twig:config>

</container>

1
2
3
4
5
6

// config/packages/twig.php
use Symfony\Config\TwigConfig;

return static function (TwigConfig $twig): void {
    $twig->defaultPath('%kernel.project_dir%/resources/views');
};

Переопределите каталог переводов

Если ваши файлы перевод не хранятся в каталоге по умолчанию translations/, используйте опцию настройки framework.translator.default_path , чтобы определить ваш собственный каталог переводов (используйте framework.translator.paths для нескольких каталогов):

1
2
3
4
5

# config/packages/translation.yaml
framework:
    translator:
        # ...
        default_path: "%kernel.project_dir%/i18n"

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

<!-- config/packages/translation.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<container xmlns="http://symfony.com/schema/dic/services"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:twig="http://symfony.com/schema/dic/twig"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/twig
        https://symfony.com/schema/dic/twig/twig-1.0.xsd">

    <framework:config>
        <framework:translator>
            <framework:default-path>%kernel.project_dir%/i18n</framework:default-path>
        </framework:translator>
    </framework:config>

</container>

1
2
3
4
5
6
7
8

// config/packages/translation.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework): void {
    $framework->translator()
        ->defaultPath('%kernel.project_dir%/i18n')
    ;
};

Переопределите публичный каталог

Если вам нужно переименовать или переместить ваш каталог public/, то единственное, что вам нужно гарантировать - чтобы путь к каталогу vendor/ был всё ещё правильным в вашем фронт-контроллере index.php . Если вы просто переименовали каталог, то всё в порядке. Но если вы переместили его куда-либо, то вам нужно будет изменить эти пути внутри этих файлов:

1

require_once __DIR__.'/../path/to/vendor/autoload.php';

Вам также нужно изменить опцию extra.public-dir в файле composer.json:

1
2
3
4
5
6
7

{
    "...": "...",
    "extra": {
        "...": "...",
        "public-dir": "my_new_public_dir"
    }
}

Переопределите каталог поставщиков

Чтобы переопределить каталогvendor/, вам нужно определить опцию vendor-dir в вашем файле composer.json следующим образом:

1
2
3
4
5
6

{
    "config": {
        "bin-dir": "bin",
        "vendor-dir": "/some/dir/vendor"
    }
}