Автозавершення оболонки

CLI Symfony підтримує автозавершення для оболонок Bash, Zsh та Fish. Це допомагає вам швидше вводити команди та знаходити доступні опції:

1
2
3
4
5
6
7
8

# встановити автозавершення (зробіть це лише один раз)
$ symfony completion bash | sudo tee /etc/bash_completion.d/symfony

# для користувачів Zsh
$ symfony completion zsh > ~/.symfony_completion && echo "source ~/.symfony_completion" >> ~/.zshrc

# для користувачів Fish
$ symfony completion fish | source

Після установки перезапустіть термінал, щоб увімкнути автозавершення. CLI також забезпечуватиме автозавершення для команд composer та console, коли виявлятиме проект Symfony.

Обслуговування вашого додатку

Щоб обслуговувати проект Symfony за допомогою локального сервера:

1
2
3
4
5

$ cd my-project/
$ symfony server:start

  [OK] Web server listening on http://127.0.0.1:8000
  ...

Тепер перейдіть за вказаним URL-адресою або виконайте наступну команду, щоб відкрити
його в браузері:

1

$ symfony open:local

Команда server:start блокує поточний термінал для виведення логів сервера. Щоб
запустити сервер у фоновому режимі:

1

$ symfony server:start -d

Тепер ви можете продовжити працювати в терміналі та виконувати інші команди:

1
2
3
4
5

# переглянути останні повідомлення логів
$ symfony server:log

# зупинити фоновий сервер
$ symfony server:stop

1

$ sudo codesign --force --deep --sign - $(whereis -q symfony)

Увімкнення PHP-FPM

Коли сервер запускається, він перевіряє наявність файлів web/index_dev.php,
web/index.php, public/app_dev.php, public/app.php у зазначеному порядку.
Якщо один із них знайдено, сервер автоматично запуститься з увімкненим PHP-FPM. В
іншому випадку сервер запуститься без PHP-FPM і покаже сторінку Page not found
при спробі отримати доступ до файлу .php у браузері.

Увімкнення HTTPS/TLS

Запуск вашого додатку через HTTPS локально допомагає виявити проблеми зі змішаним
змістом на ранній стадії та дозволяє використовувати функції, що вимагають безпечних
з'єднань. Традиційно це було болісним і складним у налаштуванні, але сервер Symfony
автоматизує все за вас:

1
2
3
4
5

# встановити авторитет сертифікату (виконайте це лише один раз на вашій машині)
$ symfony server:ca:install

# тепер запустіть (або перезапустіть) ваш сервер; він автоматично використовуватиме HTTPS
$ symfony server:start

1

$ explorer.exe `wslpath -w $HOME/.symfony5/certs`

Вибір версії PHP

Якщо на вашому комп'ютері встановлено кілька версій PHP, ви можете вказати Symfony, яку з них використовувати, створивши файл під назвою .php-version
у кореневому каталозі проекту:

1
2
3
4
5
6
7

$ cd my-project/

# використати конкретну версію PHP
$ echo 8.2 > .php-version

# використати будь-яку доступну версію PHP 8.x 
$ echo 8 > .php-version

Для того, щоб побачити всі доступні версії PHP:

1

$ symfony local:php:list

Користувацька конфігурація PHP

Перевизначіть налаштування PHP для кожного проекту, створивши файл php.ini у
кореневому каталозі проекту:

1
2
3
4
5
6

; php.ini
[Date]
date.timezone = Asia/Tokyo

[PHP]
memory_limit = 256M

Використання команд PHP

Використайте symfony php, щоб переконатися, що команди виконуються з правильною
версією PHP:

1
2
3
4
5
6
7
8

# запускається з PHP системи за замовчуванням
$ php -v

# запускається з версією PHP проекту
$ symfony php -v

# це також працює для Composer
$ symfony composer install

Встановлення локального проксі

Symfony CLI включає в себе проксі, який дозволяє використовувати користувацькі
локальні домени. Під час першого використання ві маєте сконфігурувати його наступним чином:

1. Відкрийте налаштування проксі вашої операційної системи:

   • Налаштування проксі в Windows;
   • Налаштування проксі в macOS;
   • Налаштування проксі в Ubuntu.

2. Встановіть наступний URL як значення Конфігурації автоматичного проксі:

   http://127.0.0.1:7080/proxy.pac

Тепер виконайте цю команду, щоб запустити проксі:

1

$ symfony proxy:start

Якщо проксі не працює, як пояснюється у наступних розділах, перевірте наступне:

• Деякі браузери (наприклад, Chrome) вимагають повторного застосування налаштувань проксі
  (натиснувши кнопку Re-apply settings на сторінці chrome://net-internals/#proxy) або повного перезапуску після запуску проксі. В іншому випадку ви побачите помилку «Ця веб-сторінка недоступна» (ERR_NAME_NOT_RESOLVED);
• Деякі операційні системи (наприклад, macOS) за замовчуванням не застосовують налаштування
  проксі до локальних хостів і доменів. Можливо, вам доведеться видалити *.local та/або
  інші IP-адреси зі списку.
• Windows вимагає використання localhost замість 127.0.0.1 під час конфігурації автоматичного проксі, інакше ви не зможете отримати доступ до свого локального домену з
  браузера, що працює в Windows.

Визначення локального домену

За замовчуванням Symfony використовує .wip (для В процесі розробки) як
локальний TLD для користувацьких доменів. Ви можете визначити локальний домен для ваших проектів наступним чином:

1
2

$ cd my-project/
$ symfony proxy:domain:attach my-app

Ваш додаток тепер доступний за адресою https://my-app.wip

Ви також можете використовувати підстановочні знаки:

1

$ symfony proxy:domain:attach "*.my-app"

Це доволяє отримувати доступ до до піддоменів на кшталт https://api.my-app.wip
або https://admin.my-app.wip.

При виконанні консольних команд встановить змінну середовища https_proxy, щоб змусити користувацькі домени працювати:

1
2
3
4
5
6
7
8

# приклад з cURL
$ https_proxy=$(symfony proxy:url) curl https://my-domain.wip

# приклад з Blackfire і cURL
$ https_proxy=$(symfony proxy:url) blackfire curl https://my-domain.wip

# приклад з Cypress
$ https_proxy=$(symfony proxy:url) ./node_modules/bin/cypress open

Автоматичне виявлення сервісів

З цим compose.yaml:

1
2
3
4

services:
    database:
        image: mysql:8
        ports: [3306]

Веб-сервер виявляє, що для проекту працює сервіс, який викриває порт 3306. Він розуміє, що це сервіс MySQL, і створює відповідні змінні середовища, використовуючи ім'я сервісу (database) як префікс:

• DATABASE_URL
• DATABASE_HOST
• DATABASE_PORT

Ось повний список підтримуваних сервісів з їх портами та префіксами Symfony за замовчуванням:

Якщо сервіс не підтримується, встановлюються загальні змінні середовища: PORT, IP та HOST.

Ви можете відкрити веб-інтерфейси управління для сервісів, які їх викривають, натиснувши на посилання в розділі "Сервер" веб-панелі інструментів налагодження або виконавши такі команди:

1
2

$ symfony open:local:webmail
$ symfony open:local:rabbitmq

Коли сервіси Docker працюють, перейдіть на сторінку вашого додатку Symfony і перевірте розділ "Symfony Server" на панелі інструментів веб-налагодження. Ви побачите,
що "Docker Compose" позначено як "Up".

1
2
3
4
5
6

# compose.yaml
services:
    db:
        ports: [3306]
        labels:
            com.symfony.server.service-ignore: true

Якщо ваш файл Docker Compose не знаходиться в корені проекту, використовуйте змінні середовища COMPOSE_FILE та COMPOSE_PROJECT_NAME, щоб визначити його розташування, так само як для docker-compose:

1
2
3
4
5

# запустити ваші контейнери:
COMPOSE_FILE=docker/compose.yaml COMPOSE_PROJECT_NAME=project_name docker-compose up -d

# виконати будь-яку команду Symfony CLI:
COMPOSE_FILE=docker/compose.yaml COMPOSE_PROJECT_NAME=project_name symfony var:export

Іменування сервісів

Якщо ваші імена сервісів не співпадають з угодами Symfony, використовуйте ярлики:

1
2
3
4
5
6

services:
    db:
        image: postgres:15
        ports: [5432]
        labels:
            com.symfony.server.service-prefix: 'DATABASE'

У цьому прикладі сервіс має назву db, тому змінні середовища матимуть префікс DB_, але оскільки com.symfony.server.service-prefix встановлено як
DATABASE, веб-сервер створює змінні середовища, що натомість починаються з DATABASE_, як і передбачено конфігурацією Symfony за замовчуванням.

Конфігурування робітників

Визначіть процеси, які мають запускатися автоматично з сервером, в .symfony.local.yaml:

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

# .symfony.local.yaml
workers:
    # Вбудована інтеграція з Encore
    npm_encore_watch: ~

    # Споживач Messenger зі спостереженням файлів
    messenger_consume_async:
        cmd: ['symfony', 'console', 'messenger:consume', 'async']
        watch: ['config', 'src', 'templates', 'vendor']

    # Користувацькі команди
    build_spa:
        cmd: ['npm', 'run', 'watch']

    # Автоматично запустити Docker Compose
    docker_compose: ~