Среда разработки VS Code для проектов на PHP

Расширенный пример: отладка веб-приложения с Xdebug в том же браузере

Предположим, приложение запускается на http://localhost:8080. Чтобы отладчик срабатывал при каждом запросе, настройте launch.json со следующим содержимым:

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Listen for Xdebug",
      "type": "php",
      "request": "launch",
      "port": 9003,
      "xdebug.idekey": "VSCODE"
    },
    {
      "name": "Launch index.php",
      "type": "php",
      "request": "launch",
      "program": "${workspaceRoot}/index.php",
      "cwd": "${workspaceRoot}",
      "port": 9003,
      "xdebug.idekey": "VSCODE"
    }
  ]
}

Убедитесь, что в php.ini вашего веб-сервера заданы:

xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=host.docker.internal  # если в контейнере
xdebug.client_port=9003

Запустите отладку (F5), откройте браузер по адресу приложения. Когда код дойдёт до точки останова, VS Code остановится и покажет переменные.

Результат: в консоли отладчика появятся значения переменных, можно пошагово исполнять код.

Пример настройки tasks.json для автоматизации Composer

Создайте в папке .vscode файл tasks.json:

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "composer update",
      "type": "shell",
      "command": "composer update",
      "group": "build",
      "problemMatcher": []
    },
    {
      "label": "run tests",
      "type": "shell",
      "command": "./vendor/bin/phpunit",
      "group": "test",
      "presentation": {
        "reveal": "always"
      }
    }
  ]
}

Теперь через Ctrl+Shift+B можно запускать composer update, а через панель задач (или сочетание клавиш) – тесты.

Результат выполнения в терминале: появляется вывод composer или phpunit с цветным логом.

Пример конфигурации PHP CS Fixer с кастомными правилами

Создайте файл .php-cs-fixer.php в корне проекта:

<?php

$finder = PhpCsFixer\Finder::create()
    ->in(__DIR__)
    ->exclude('vendor');

return (new PhpCsFixer\Config())
    ->setRules([
        '@PSR12' => true,
        'array_syntax' => ['syntax' => 'short'],
        'no_unused_imports' => true,
        'ordered_imports' => ['sort_algorithm' => 'alpha'],
    ])
    ->setFinder($finder);

После настройки расширения vscode-php-cs-fixer при сохранении файла он будет автоматически отформатирован: короткий синтаксис массивов, удалены неиспользуемые импорты, импорты отсортированы по алфавиту.

Результат: код приводится к единому стилю.

Пример работы с Docker и remote-контейнером для Laravel

Структура проекта:

.
├── .devcontainer/
│   ├── devcontainer.json
│   └── Dockerfile
├── docker-compose.yml
└── src/

Dockerfile (минимальный):

FROM php:8.2-fpm
RUN apt-get update && apt-get install -y git unzip \
    && pecl install xdebug && docker-php-ext-enable xdebug \
    && curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
COPY --from=node:18 /usr/local/bin/node /usr/local/bin/node

docker-compose.yml:

version: '3.8'
services:
  php:
    build: .
    volumes:
      - ./src:/app
    working_dir: /app
    environment:
      - XDEBUG_MODE=debug
      - XDEBUG_SESSION=VSCODE
  nginx:
    image: nginx:alpine
    ports:
      - "8080:80"
    volumes:
      - ./src:/app
      - ./nginx.conf:/etc/nginx/conf.d/default.conf

После открытия папки в VS Code предложит переоткрыть в контейнере. Внутри контейнера отладка настраивается так же, только в launch.json добавляют pathMappings как в основном разделе.

Результат: полное окружение с PHP, Xdebug, Composer, Nginx, всё изолировано и готово к разработке.

Пример продвинутого сниппета для репозитория-паттерна Repository

Сниппет генерирует полноценный класс репозитория с внедрением зависимости Eloquent модели:

{
  "Repository": {
    "prefix": "repo",
    "body": [
      "<?php",
      "",
      "namespace App\\${1:Repositories};",
      "",
      "use App\\Models\\${2:Model};",
      "",
      "class ${2:Model}Repository",
      "{",
      "    protected \\${2:Model} \\$model;",
      "",
      "    public function __construct(\\${2:Model} \\$model)",
      "    {",
      "        \$this->model = \$model;",
      "    }",
      "",
      "    public function find(\$id): ?\\${2:Model}",
      "    {",
      "        return \$this->model->find(\$id);",
      "    }",
      "}"
    ],
    "description": "Create a Repository class with dependency injection"
  }
}

При вводе repo и Tab создаётся полный класс, нужно только указать имя модели.

Результат: экономия времени и единообразие кода.