PhpStorm пустая директория FTP

Иногда при подключении по FTP возникает странная ситуация:

• соединение устанавливается успешно;
• ошибок авторизации нет;
• но директории отображаются пустыми.

Хотя на сервере файлы точно существуют.

Чаще всего проблема связана с неправильно выбранным режимом FTP:

• Active Mode;
• Passive Mode.

Активный и пассивный режим FTP

FTP использует два соединения:

• для команд;
• для передачи данных.

Именно способ создания соединения передачи данных и определяет режим работы FTP.

Активный режим FTP

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

Такой режим часто блокируется:

• NAT;
• роутерами;
• фаерволами;
• антивирусами.

Пассивный режим FTP

В пассивном режиме сервер сообщает клиенту TCP-порт, а клиент сам инициирует подключение для передачи данных.

Именно поэтому passive mode обычно работает стабильнее.

Почему директория FTP отображается пустой

Если режим FTP выбран неправильно, может не работать:

• получение списка файлов;
• открытие директорий;
• загрузка файлов;
• передача данных.

В результате FTP-клиент подключается, но не может получить содержимое папок.

Как исправить проблему в PhpStorm

В PhpStorm открываем:

Settings → Deployment → Advanced Options

И меняем параметр:

• Passive mode.

Нужно:

• либо поставить галочку;
• либо снять ее.

После изменения режима переподключаемся к FTP.

Когда использовать Passive Mode

Пассивный режим рекомендуется:

• при работе через роутер;
• NAT;
• корпоративные сети;
• фаерволы;
• облачные VPS;
• большинство современных FTP-серверов.

Когда может помочь Active Mode

Активный режим иногда используется:

• в старых сетях;
• локальных инфраструктурах;
• при специфических настройках сервера.

Дополнительно стоит проверить

• открыты ли FTP-порты;
• не блокирует ли соединение firewall;
• правильно ли указан FTP root;
• используется ли FTPS/SFTP вместо FTP.

Итог

Если FTP подключается, но директории отображаются пустыми, чаще всего проблема связана с режимом работы FTP.

В PhpStorm достаточно переключить:

Passive mode

в настройках Deployment, и файлы снова начнут отображаться корректно.