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

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: ~