Базовый перенос файла

Самым базовым способом развёртывания приложения является копирование файлов вручную с помощью FTP/SCP (или схожего метода). Этот способ имеет свои недостатки, так как вам будет не хватать контроля над системой по мере прогрессирования улучшений. Этот метод также требует некоторых ручных действий после переноса файлов (см. Распространённые задачи развёртывания).

Использование системы управления исходным кодом

Если вы используете системы управления исходным кодом (например, Git или SVN), вы можете упростить себе жизнь, если ваша живая инсталляция также будет копией вашего хранилища. Когда вы будете готовы к улучшению (апгрейду), все что вам нужно будет сделать - это вызвать последние обновления из вашей системы контроля исходного кода. При использовании Git распространённым подходом является создание тега для каждого релиза и проверка соответствующего тега при развёртывании (см. Тегирование Git).

Это облегчает обновление ваших файлов, но вам все еще надо беспокоиться о том, чтобы выполнять другие шаги вручную (см. Распространённые задачи развёртывания).

Использование платформ в качестве сервиса

Использование платвормы в качестве сервиса (PaaS) может быть отличным способом развернут ваше приложение Symfony быстро и легкоо. Существует множество PaaS, но мы рекомендуем Platform.sh, так как она предоставляет посвящённую Symfony интеграцию и помогает развивать Symfony.

Использование скриптов компоновки и других инструментов

Существуют также инструменты, которые облегчают муки развёртывания. Некоторые из них были специально подогнаны под требования Symfony.

Deployer

Это ещё одна родная перезапись PHP Capistrano, с некоторыми готовыми рецептами для Symfony.

Ansistrano

Роль Ansible, которая позволяет вам конфигурировать мощное развёртывание через YAML файлы.

Magallanes

Этот инструмент развёртывания, похожий на Capistrano, встрое в PHP и может быть ленче для PHP-разработчиков в контексте его расширения под их нужды.

Fabric

Эта библиотека, основанная на Python, предоставляет базовый набор операций для выполнения локальных или удаленных shell-команд и загрузки/скачивания файлов.

Capistrano с плагином Symfony

Capistrano - это удалённая автиматизация сервера и инструмент развёртывания, написанный на Ruby. Плагин Symfony - это плагин для облегчения задач, связанных с Symfony, основанный на Capifony (который работает только с Capistrano 2).

A) Проверка требований

Существуют некоторые технические требования для запуска приложений Symfony . На вашем машине разработки, рекомендованым способом проверки этих требований является Symfony CLI. Однако, на вашем сервере производства, вы можете предпочесть не устанавливать инструмент Symfony CLI. В таких случаях, установите этот другой пакет в вашем приложении:

1

$ composer require symfony/requirements-checker

Затем, убедитесь, что проверщик включен в ваши скрипты Composer:

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

{
    "...": "...",

    "scripts": {
        "auto-scripts": {
            "vendor/bin/requirements-checker": "php-script",
            "...": "..."
        },

        "...": "..."
    }
}

B) Конфигурация ваших переменных окружения

Большинство приложений Symfony считывают конфигурацию из переменных окружения. При локальной разработке вы обычно храните её в .env и .env.local (для локальных переопределений). Но при производстве у вас есть два варианта:

1. Создать "настоящие" переменные окружения. То, как вы устанваливаете переменные окружения, зависит от ваших настроек: они могут быть установлены в командной строке, в вашей конфигурации Nginx или черещ другие методы, предоставленные вашими сервисами хостинга;
2. Или создать файл .env.local как вашу локальную разработку.

Ни у одного варианта нет существенных преимуществ: используйте тот, который наиболее природный в вашем окружении хостинга.

1

$ composer dump-env prod

1

$ composer dump-env prod --empty

1
2
3

# config/services.yaml
services:
    Symfony\Component\Dotenv\Command\DotenvDumpCommand: ~

1

$ APP_ENV=prod APP_DEBUG=0 php bin/console dotenv:dump

C) Установка/обновление ваших поставщиков

Ваши поставщики могут быть обновлены до переноса вашего исходного кода (т.е. вы обновляете каталог vendor/, потом переносите его с вашим исходным кодом) или же после, уже на сервере. В любом случае, просто обновите ваших поставщиков так, как обычно:

1

$ composer install --no-dev --optimize-autoloader

D) Очистка вашего кеша Symfony

Убедитесь в том, что вы очистили и разогрели ваш кеш Symfony:

1

$ php bin/console cache:clear --env=prod --no-debug

E) Другие вещи!

Существует еще масса других вещей, которые вам может понадобиться сделать, в зависимости от вашей установки:

• Запуск любых перемещений базы данных
• Очистка вашего APC-кеша
• Добавление/изменение работ CRON
• Построение и минимизирование ваших ресурсов with Webpack Encore
• Отправка ресурсов в CDN
• На общих хостинговых платформах, использкющих веб-сервер Apache, вам может понадобиться установить пакет symfony/apache-pack

• ---

Развёртывания, не использующие файл composer.json

Корневой каталог проекта (значение которого используется через параметр kernel.project_dir и метод getProjectDir()) высчитывается Symfony автоматически, как каталог, где хранится основной файл composer.json.

В развертываниях, не использующих файл composer.json, вам понадобится переопределить мтеод getProjectDir() method как объясняется в этом разделе .