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

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

Використання системи управління початковим кодом

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

Це полегшує оновлення ваших файлів, але вам все ще необхідно турбуватися про те, щоб виконувати інші кроки вручну (див. Розповсюджені задачі розгортання).

Використання платформ в якості сервісу

Використання платформи у якості сервісу (PaaS) може бути чудовим способом розгорнути ваш застосунок Symfony швидко та легко. Існує безліч PaaS, but we recommend Platform.sh as it provides a dedicated Symfony integration and helps fund the Symfony development.

Використання скриптів побудови та інших інструментів

Існують також інструменти, які полегшують муки розгортання. Деякі з них були спеціально підігнані під вимоги 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
• Побудова та мінімізація ваших ресурсів з Webpack Encore
• Відправка ресурсів у CDN
• На загальних хостингових платформах, які використовують веб-сервер Apache, вам може знадобитися встановити пакет symfony/apache-pack
• інше

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

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

В розгортаннях, що не використовують файл composer.json, вам знадобиться перевизначити метод getProjectDir() як пояснюється у цьому розділі .