Перейти к основному содержимому

PHP

OpenIDE работает с PHP через плагин PHP for OpenIDE из маркетплейса: автодополнение и проверки кода, Composer, внешние анализаторы, тесты PHPUnit, встроенный веб-сервер, отладка и профилирование через Xdebug, Laravel и Symfony. Интерпретатор может быть локальным, в Docker или в Docker Compose. В том же окне — DB-клиент, Docker и AI-агенты.

Описано по версии 0.9.9 (21.10.2026).

Редакция: базовая поддержка языка в OpenIDE, полная поддержка языка и фреймворков в OpenIDE Pro.

Плагин: PHP for OpenIDE

В бесплатной OpenIDE доступны подсветка, автодополнение, навигация и отладка. Поддержка фреймворков, внешние анализаторы, профилировщик, шаблонизаторы и работа через WSL входят в OpenIDE Pro.

Проект konfa в OpenIDE: в редакторе FeedbackService.php с методами rate, average и hasRatings; рядом с объявлениями подсказки «3 использования», «2 использования» и «1 использование», в вызовах array_map, array_filter и round — имена параметров и выведенный тип массива. Слева дерево проекта с папкой feedback, файлами composer.json и index.php

PHP-файл в редакторе: число использований у объявлений, подсказки типов и имён параметров.

Что поддерживается​

ВозможностьЧто есть
ИнтерпретаторПрофили Local, Docker и Docker Compose; активный профиль используется для запуска, отладки и Composer
ComposerУведомление о неустановленных зависимостях, composer install из IDE, путь, флаги и переменные окружения
РедакторАвтодополнение с выводом типов, подсказки типов и имён параметров, PHPDoc, HTML, CSS и Emmet в шаблонах, Twig и Blade
Навигация и рефакторингПереход к объявлению, поиск использований, переход по @inheritDoc, переименование, оптимизация импортов
Анализ кодаВстроенные проверки и быстрые исправления; PHPStan, Psalm, Mago, PHP_CodeSniffer, PHP CS Fixer; Rector с предпросмотром
ТестыPHPUnit: запуск из кода и дерева проекта, дерево результатов, покрытие, в том числе из Docker и Docker Compose
ЗапускВстроенный веб-сервер PHP; worker-серверы FrankenPHP, RoadRunner, Swoole и OpenSwoole
ОтладкаXdebug: точки останова, вычисление выражений, удалённая отладка, DBGp-прокси, сопоставление путей
ПрофилированиеПрофилировщик Xdebug: дерево вызовов, граф пламени, горячие точки, открытие готовых cachegrind-файлов
ФреймворкиLaravel, Symfony; миграции Doctrine, Phinx и Laravel; OpenAPI из атрибутов; API Platform, Symfony Messenger
Версии PHPУровень языка из composer.json и интерпретатора; PHP 8.6 — предварительно

Установка​

  1. Скачайте OpenIDE или OpenIDE Pro. Pro работает 60 дней без регистрации — см. Пробный период.
  2. Откройте Настройки → Плагины → Маркетплейс (Settings → Plugins → Marketplace), найдите PHP for OpenIDE и установите.
  3. Перезапустите IDE.

Обновления плагина приходят в Настройки → Плагины (Settings → Plugins). Если плагин не находится в маркетплейсе внутри IDE, обновите OpenIDE до актуальной версии. Установка плагинов из файла описана в разделе Маркетплейс и плагины.

Интерпретатор PHP​

Интерпретаторы настраиваются в Настройки → Языки и фреймворки → PHP (Settings → Languages & Frameworks → PHP), в таблице Профили интерпретаторов. Профиль бывает локальным, Docker или Docker Compose. Активный профиль (точка в колонке Active) используется для запуска, отладки и Composer.

  1. Нажмите + над таблицей и укажите интерпретатор: локальный PHP, образ Docker или сервис Docker Compose.
  2. Выберите профиль и сделайте его активным кнопкой с галочкой.
  3. Проверьте Уровень языка PHP. Значение Авто берёт версию из composer.json и интерпретатора.

Настройки → Языки и фреймворки → PHP: таблица «Профили интерпретаторов» с активным профилем PHP, уровень языка «Авто (8.3 composer.json)», путь к Composer, флаг --ignore-platform-reqs, поля COMPOSER_MEMORY_LIMIT, Composer env и Include path

Страница настроек PHP: профили интерпретатора, уровень языка и параметры Composer.

Если PHP на машине не найден, IDE показывает уведомление Интерпретатор PHP не найден с действием Скачать PHP…; то же действие есть кнопкой со стрелкой над таблицей профилей. Если скачать не получилось, установите PHP средствами ОС и добавьте профиль кнопкой +.

Для отладки и профилирования в интерпретаторе должно быть установлено расширение Xdebug.

Composer​

Когда в проекте есть composer.json, а vendor/ ещё нет, IDE показывает уведомление Зависимости Composer не установлены. Действие Выполнить composer install запускает установку, вывод появляется в окне Запустить.

На той же странице настроек PHP задаются:

  • Composer path — путь к Composer, кнопка Detect находит его автоматически;
  • Composer flags — например, --ignore-platform-reqs;
  • COMPOSER_MEMORY_LIMIT и Composer env — переменные окружения для Composer, по одной KEY=VALUE на строку;
  • Include path — внешние каталоги с PHP-кодом: библиотеки вне проекта и vendor/.

Проект abonement-php: открыт FineCalculator.php, в окне «Запустить» вкладка «Composer install» с прогрессом распаковки пакетов 29 из 29

composer install из уведомления: зависимости ставятся активным интерпретатором, вывод — в окне «Запустить».

Автодополнение и навигация​

Автодополнение предлагает методы и свойства классов проекта с параметрами. Типы выводятся из кода: после assert($x instanceof A) IDE предлагает методы класса A, в foreach и catch учитываются типы элементов, ключей и исключений, а новое присваивание сбрасывает прежний тип переменной. Имя свойства дополнение предлагает по его типу. В редакторе видны выведенные типы переменных, имена параметров в вызовах и число использований над объявлениями.

index.php: строка $sum = $calc->total($library->overdue($today), $today) с подсказками типов int, Library и Loan и именами параметров loans, datetime, value

Подсказки типов и имён параметров прямо в коде.

Навигация и рефакторинг:

  • переход к объявлению класса, метода или функции;
  • поиск использований: все вызовы метода в коде и тестах;
  • переход по @inheritDoc к методу интерфейса или родительского класса, при нескольких целях — выбор;
  • переименование (Shift+F6) прямо в коде, вызовы в других файлах обновляются;
  • структура файла и класса.

FineCalculator.php и окно «Найти»: 7 использований метода fine в файлах проекта — в bin/report.php, public, src и четыре в tests; справа строка вызова из report.php

Поиск использований показывает, какой код затронет изменение метода.

PHPDoc, импорты и проверки​

  • Импорты. Оптимизация импортов удаляет неиспользуемые use, в том числе части составных импортов, и сохраняет имена, нужные коду и PHPDoc. Неиспользуемый импорт подсвечен серым, в списке действий есть Удалить неиспользуемый импорт. Полное имя класса импортируется через Alt+Enter (на macOS Option+Enter).
  • PHPDoc. Класс из PHPDoc импортируется через Alt+Enter, даже если включён внешний анализатор. Типы из PHPDoc, включая generics вида list<Loan>, участвуют в выводе типов. Проверка необработанных исключений учитывает @throws.
  • Проверки. IDE подсвечивает проблемы до запуска анализаторов: например, у метода нет типа возвращаемого значения и из-за этого вызывающий метод возвращает int|float вместо int. Исправления — в списке по Alt+Enter.
  • Форматирование. Форматтер ставит пробел после приведения типа: (int) $x.

Внешние анализаторы​

Поддерживаются PHPStan, Psalm, Mago, PHP_CodeSniffer и PHP CS Fixer. Найти страницу настроек нужного инструмента проще всего поиском по имени в окне настроек.

  • У каждого инструмента своя страница: способ запуска, параметры, режим проверки, исключённые файлы и папки.
  • Для одного инструмента можно завести несколько именованных конфигураций со своими путями, параметрами и исключениями — например, для разных частей проекта. Все включённые конфигурации выполняются независимо.
  • Анализаторы запускаются через PHP-интерпретатор проекта, в том числе в Docker и WSL.
  • Настройки проекта хранятся в git, а личные пути и выбор интерпретатора остаются на машине разработчика.
  • Проверка всего проекта запускает все включённые инструменты.
  • Если анализатор завершился с ошибкой или его находку не удалось сопоставить с файлом, IDE сообщает об этом, а не показывает пустой результат.
  • Mago используется и для архитектурных проверок через guard, и для форматирования через Reformat Code. Конфигурация форматирования выбирается отдельно от анализа.
  • Для PHPStan и Psalm доступны создание и обновление baseline и режимы проверки проекта Incremental и Full.

Rector с предпросмотром​

Rector запускается для файла, каталога или проекта. Показать изменения открывает окно выбора: слева файлы и фрагменты с флажками, справа код до и после. Применяются только отмеченные фрагменты, отменить правку можно обычным Undo.

Окно выбора изменений Rector: отмечены файл и фрагмент, в сравнении строка return $this-&gt;returnedAt !== null заменена на instanceof \DateTimeImmutable, кнопка «Применить выбранные изменения Rector»

Предпросмотр Rector: какие правки применить, решаете до записи в файл.

Встроенный веб-сервер​

Значок запуска на полях index.php создаёт конфигурацию PHP Web Server и запускает встроенный сервер PHP: корень сайта — папка public/, порт — 8000. Лог запросов идёт в окно Запустить, адрес сервера кликабелен.

index.php и окно «Запустить» с конфигурацией PHP Web Server (PHP (public/)): команда php -S localhost:8000 -t …/public, строка «PHP 8.5.12 Development Server started» и запросы GET с кодом 200

Встроенный сервер PHP запускается из файла без ручной настройки конфигурации.

Для долгоживущих приложений есть конфигурации worker-серверов FrankenPHP, RoadRunner и Swoole/OpenSwoole: выбор PHP, окружение, логи и перезапуск после сохранения.

Тесты PHPUnit​

  • Класс или метод — значок запуска на полях рядом с тестовым классом или методом.
  • Файл или каталог — контекстное меню в дереве проекта, включая вложенные папки.

Результаты показываются в дереве тестов: упавший тест, сообщение, переход к коду, повторный запуск. Тот же тест запускается под отладчиком. Если выбранный локальный PHPUnit не найден, IDE останавливает запуск до старта PHP и предлагает выполнить composer install или указать путь.

FineCalculatorTest.php и дерево «Результаты тестов»: 1 test failed, 3 passed, упал testCappedAtFiveHundred; в консоли запуск vendor/bin/phpunit, PHPUnit 11.5.57 на PHP 8.5.12

Дерево результатов PHPUnit: упавший тест виден сразу, из него можно перейти к коду.

Покрытие PHPUnit, в том числе при запуске в Docker и Docker Compose, отображается в редакторе: видно, какие строки выполнялись. Сохранённый отчёт о покрытии можно открыть повторно.

Отладка через Xdebug​

  1. Поставьте точку останова щелчком по полю редактора.
  2. Запустите скрипт, сервер или тест под отладчиком — значком отладки на панели или на полях.
  3. При остановке значения переменных — в окне Отладка на вкладке Потоки & Переменные, стек вызовов — слева. Выражения считаются в поле Вычислить выражение.

Отладка теста FineCalculatorTest::testCappedAtFiveHundred: остановка на строке return min(...) в FineCalculator.php, слева стек кадров PHPUnit, справа узел Superglobals с $argv, $argc, $_GET, $_POST, $_COOKIE

Остановка в методе под Xdebug. Локальные переменные — ниже узла Superglobals.

Массивы из отладчика копируются как print_r, var_export или json_encode. Сессия отладки не обрывается после 30 секунд ожидания.

Удалённая отладка. Для отладки на сервере или в контейнере используется конфигурация PHP Remote Debug. Серверные пути сопоставляются с локальными при всех способах запуска отладки — для скриптов, встроенного веб-сервера и PHP Remote Debug. Если файл не найден по одному правилу, отладчик пробует следующие, а при неудаче показывает проблемный путь в консоли.

DBGp-прокси. Если один сервер отлаживают несколько разработчиков, прокси направляет сессию в IDE нужного разработчика по IDE key.

Профилирование через Xdebug​

Для локального скрипта есть действие Run with Xdebug Profiler. IDE передаёт PHP параметры Xdebug (xdebug.mode=profile и каталог для отчёта), а готовый профиль открывает в окне Profiling Tools. Профиль показан тремя видами:

  • Дерево вызовов — кто кого вызвал и сколько это стоило;
  • Граф пламени — где программа проводит время;
  • Горячие точки — функции с числом вызовов, собственным и общим временем, с переходом к PHP-коду.

Окно Profiling Tools, вкладка PHP: report.php, вид «Граф пламени»; слева скрипт report.php, внизу вкладка «Профилировщик PHP» с командой php -d xdebug.mode=profile

Граф пламени профиля скрипта, запущенного из IDE.

Вид «Горячие точки»: колонки «Функция», «Вызовы», «Собственное время», «Общее время», «Всего %»; конструктор DateTimeImmutable вызван 40 001 раз и занимает 15% времени

Горячие точки: таблица функций с числом вызовов и долей времени.

Готовые cachegrind-файлы, например снятые на сервере, открываются через Открыть профиль Xdebug. Другие профилировщики IDE описаны в разделе Профилирование.

Фреймворки и шаблоны​

  • Laravel и Symfony. Заявлены в плагине с первой бета-версии. По сравнению редакций: для Symfony — Service Container, Routing, Doctrine, Twig, Forms и Events; для Laravel — Container и Facades, Eloquent, Blade и Artisan.
  • Yii2 и Yii3. По сравнению редакций: ActiveRecord и Query Builder, консольные контроллеры, генератор Gii.
  • Шаблоны. Twig и Blade поддерживаются, Smarty — нет. В PHP-файлах подсвечивается HTML, работает CSS внутри шаблонов, сокращения Emmet раскрываются по Tab в HTML-части файла.
  • Миграции. Doctrine Migrations, Phinx и Laravel из общего диалога: создание, статус, применение и откат.
  • API. Генерация OpenAPI из PHP-атрибутов через swagger-php, обозреватели ресурсов API Platform и сообщений Symfony Messenger.
  • Конфигурации серверов. Подсветка и дополнение в конфигурациях Nginx и Apache.

Версии PHP​

Уровень языка задаётся в Настройки → Языки и фреймворки → PHP (Settings → Languages & Frameworks → PHP) → Уровень языка PHP. По умолчанию (Авто) он определяется из composer.json и интерпретатора.

PHP 8.6 поддерживается предварительно: частичное применение функций, readonly-свойства со значениями по умолчанию, #[\Override] у констант. Две новые проверки для 8.6 по умолчанию выключены.

Рядом с кодом​

База данных. DB-клиент подключается к MySQL, PostgreSQL, ClickHouse, SQLite и другим СУБД: дерево схемы, SQL-консоль с дополнением по таблицам, таблица результатов с фильтрами и экспорт. Подробнее — DB-клиент.

DB-клиент: таблица returns базы abonement, фильтр WHERE DATEDIFF(returned_at, due_at) &gt;= 31 и ORDER BY returned_at, внизу Total: 74 rows; справа дерево подключения abonement

Данные проекта проверяются запросом в том же окне, где лежит код.

Docker. Базу для разработки можно поднять из docker-compose.yml значком запуска у services:; compose-проект, сервисы и контейнеры появятся в Docker Explorer. Интерпретатор PHP тоже может работать в Docker или Compose — это тип профиля в настройках PHP. Подробнее — Docker.

docker-compose.yml с сервисом db на образе mysql:8.4 и окно Docker Explorer: compose-проект abonement-php, сервис db, контейнер abonement-php-db-1 и сеть abonement-php_default

MySQL из docker-compose.yml запускается без терминала.

Выкладка на сервер. Файлы передаются на сервер по SFTP, FTP и FTPS плагином Deployments (маркетплейс).

AI-агенты. В OpenIDE Pro агенты Claude Code, Codex, OpenCode, Cursor и другие подключаются через протокол ACP: задача агенту, проверка изменений в редакторе, запуск приложения. Подробнее — AI-агенты.

Вкладка «Новый ИИ-чат» рядом с FineCalculator.php: заголовок «Чем займёмся сегодня?», поле ввода сообщения, выбор агента OpenCode, модели Crouton Alpha Free и режима Build

Новый чат с агентом открывается вкладкой рядом с кодом.

Частые вопросы​

PHP есть в бесплатной OpenIDE?​

Да. Плагин ставится в OpenIDE и OpenIDE Pro. В бесплатной версии — базовая поддержка языка: подсветка, автодополнение, навигация, отладка. Фреймворки, внешние анализаторы, профилировщик и шаблонизаторы относятся к Pro — см. блок в начале страницы.

Поддерживаются ли Laravel и Symfony?​

Да, оба фреймворка заявлены в плагине с первой бета-версии. Кроме того, есть миграции Laravel и Doctrine, обозреватели API Platform и Symfony Messenger. Поддержка фреймворков относится к OpenIDE Pro.

Какие шаблонизаторы поддерживаются: Twig, Blade, Smarty?​

Twig и Blade поддерживаются, Smarty — нет.

Подсвечивается ли HTML внутри PHP-файлов?​

Да. В HTML-части PHP-файла работают подсветка, CSS и сокращения Emmet по Tab.

Как сгенерировать PHPDoc для функции?​

В Настройки → Языки и фреймворки → PHP (Settings → Languages & Frameworks → PHP) включите флажок Generate @param/@return skeleton on /** + Enter. После этого /** и Enter над функцией создают заготовку PHPDoc с @param и @return.

Плагин PHP не находится в маркетплейсе или не устанавливается​

Обновите OpenIDE до актуальной версии: плагин требует свежую платформу. Ставьте плагин из маркетплейса OpenIDE — плагин PHP из JetBrains Marketplace проприетарный и в OpenIDE не работает.

Можно ли отлаживать общий сервер через DBGp-прокси?​

Да. Прокси направляет сессию отладки в IDE нужного разработчика по IDE key — см. Отладка через Xdebug.

PHP в Docker под WSL: анализаторы не запускаются, пути не сопоставляются​

Обновите плагин: анализаторы запускаются через интерпретатор проекта, в том числе в Docker и WSL, а сопоставление путей работает при всех способах запуска отладки. Для проекта, который целиком лежит в WSL, используйте плагин Remote Targets (маркетплейс) (OpenIDE Pro).

Есть ли выкладка файлов на сервер по SFTP, как в PhpStorm?​

Да, плагином Deployments (маркетплейс): FTP, FTPS и SFTP, дерево сервера, сравнение версий и автозагрузка после сохранения.

Что приложить к сообщению об ошибке?​

Версии IDE, плагина и PHP, composer.json и шаги воспроизведения. Логи собираются через Помощь → Собрать логи и диагностические данные (Help → Collect Logs and Diagnostic Data). Куда писать — в разделе Поддержка и обратная связь.

Что дальше​