Установка и настройка
Откройте файл ~/.ssh/config
Удостоверьтесь, что у вас есть запись для хоста с примерно следующим содержанием:
- Linux
- MacOS
Host
HostName <ip address>
User <user name>
Port <port>
PKCS11Provider /usr/lib/x86_64-linux-gnu/opensc-pkcs11.so
Host
HostName <ip address>
User <user name>
Port <port>
PKCS11Provider /usr/local/lib/opensc-pkcs11.so
Это понадобится, чтобы плагин смог сам настроить git remote.
Перейдите в настройки → Tools → SSH Configurations
Удостоверьтесь, что у вас здесь есть нужное подключение к .
Если у вас нет нужной конфигурации, то создайте новую и заполните поля, как показано
на скриншоте ниже.
Если у вас несколько конфигураций, то сделайте подключение к
первым, чтобы при запуске IDE могла сразу же подключаться к нужному серверу.
Перейдите в настройки → Build, Execution, Deployment → Deployment → Options
Удостоверьтесь, что в пункте
Upload changed files automatically to the default server
установлено значение Always или
On explicit save action.
Это нужно, чтобы уменьшить количество необходимых ручных синхронизаций связанных
с файлами. Если этот пункт будет установлен в значение
Never, то каждое изменение
в файлах необходимо будет загружать вручную, когда вам понадобиться, например,
запустить KPHP.
Установка плагина в PHPStorm
JetBrains больше не может предоставлять услуги VK как компании из РФ,
поэтому все наши плагины распространяются
не через официальный Marketplace, а через наш собственный.
Settings → Plugins → ⚙️ → Manage plugin repositories:
Добавляем адрес https://idea-plugins.kphp.dev
Закрываем окно настроек через ОК и открываем настройки заново.
Теперь он должен находиться по запросу (иногда без иконки):
Первый запуск
После того, как плагин установлен, а конфигурация SSH настроена, запускаем IDE.
Обратите внимание, чтобы всё заработало правильно, проект vkcom должен быть открыт
в его корневом каталоге (там где находится
composer.json).
При каждом запуске плагин автоматически начнёт подключаться к серверу.
Если в этот момент сеть будет недоступна, то он покажет уведомление о том, что
подключиться не удалось.
В этом случае, чтобы использовать возможности плагина, вам необходимо будет
подключиться вручную.
Для этого перейдите в меню
.
После клика вам будет предложен список конфигураций SSH к которым можно подключиться.
Выберите нужный, и плагин снова начнёт автоматическую настройку.
Во время первой настройки плагин создаст новый git remote с именем
через который
он будет совершать все действия с сервером. Если такой remote уже существует, он будет
использовать его.
Про юбик
Наш юбик любит частенько отваливаться, из-за чего запуск некоторых команд
может быть невозможен.
В такие моменты плагин покажет уведомление, о том что соединение было потеряно и
предложит автоматически перезагрузить юбик, плагин автоматически
выполнит все необходимые действия (может потребоваться ввод пин-кода).
Вы также можете перезапустить его сами и нажать на Just Reconnect.
После этого можно запускать команду вновь.
Иногда во время выполнения команды может быть потеряно соединение, в таком случае
вам будет показано окно с сообщением об этом.
В таком случае вы также можете автоматически перезагрузить юбик кнопкой
Auto Reset and Try Again, или сбросить самостоятельно
юбик и нажать Try Again, плагин сам перезапустит команду.
Не забывайте трогать юбик, когда будете использовать возможности плагина.
Так как всё делается через SSH, это нужно будет делать довольно часто.
Настройки плагина
У плагина есть различные настройки которые вы можете изменять под ваши потребности. Их можно найти в настройках .
