PHP-разработка: от текстового редактора до профессиональной среды

Расширенные примеры конфигурации и использования редакторов PHP

1. Настройка Xdebug с Docker в VS Code

В проекте на Laravel с Docker организуется отладка через Xdebug, когда веб-сервер работает внутри контейнера. Файл docker-compose.yml должен пробросить порт 9003 и установить переменные окружения:

version: '3.8'
services:
  app:
    image: php:8.2-fpm
    environment:
      XDEBUG_MODE: debug
      XDEBUG_CLIENT_HOST: host.docker.internal
      XDEBUG_CLIENT_PORT: 9003
    extra_hosts:
      - "host.docker.internal:host-gateway"
    ports:
      - "9003:9003"

В VS Code в launch.json добавить конфигурацию с pathMappings:

{
    "name": "Docker Xdebug",
    "type": "php",
    "request": "launch",
    "port": 9003,
    "pathMappings": {
        "/var/www/html": "${workspaceFolder}"
    }
}

Результат:

Точки останова срабатывают, отладчик показывает стек вызовов, переменные и watch.

2. Автодополнение для Laravel в PhpStorm

PhpStorm автоматически подхватывает фасады и элорквенты после индексации. Если автодополнение не работает, нужно перестроить кеш: File -> Invalidate Caches и Restart. Пример кода, который должен срабатывать:

use App\Models\User;
$users = User::where('active', 1)->get();
foreach ($users as $user) {
    echo $user->name;
}

После переиндексации PhpStorm подсказывает методы where, get, name. Если подсказки всё равно нет - проверьте, не исключил ли редактор папку vendor из индексации.

3. PHP CodeSniffer в Sublime Text

Установка пакета Phpcs через Package Control. Пример настройки конфигурации (Tools -> Phpcs -> Settings):

{
    "phpcs_path": "/usr/local/bin/phpcs",
    "phpcs_args": "--standard=PSR12",
    "phpmd_path": "/usr/local/bin/phpmd",
    "phpmd_args": "cleancode,design,naming,unusedcode"
}

При сохранении файла редактор подсвечивает строки с нарушениями стандарта PSR-12. Например, неправильный отступ или лишние пробелы в конце строки.

// Пример вывода Phpcs в консоли Sublime:
FILE: /path/to/file.php
----------------------------------------------------------------------
FOUND 2 ERRORS AFFECTING 2 LINES
----------------------------------------------------------------------
 1 | ERROR | [x] Header comment must not contain empty line
 5 | ERROR | [x] Expected 1 space after opening parenthesis; 0 found

4. Использование PHPUnit в Neovim с coc.nvim

Установите phpunit глобально через Composer. Настройте тестовый runner в Neovim:

" .vimrc
let g:test#php#phpunit#executable = 'php vendor/bin/phpunit'
" сопоставление клавиш для запуска ближайшего теста
nmap <leader>t :TestNearest<CR>
nmap <leader>T :TestFile<CR>

Пример теста:

<?php
use PHPUnit\Framework\TestCase;

class MathTest extends TestCase
{
    public function testAddition()
    {
        $this->assertEquals(4, 2 + 2);
    }
}

При нажатии <leader>t в Neovim открывается терминал с результатом:

PHPUnit 10.5.0 by Sebastian Bergmann and contributors.

.   1 / 1 (100%)

Time: 0.02 seconds, Memory: 6.00 MB

OK (1 test, 1 assertion)

5. Проблемы с кодировкой в PHP на разных редакторах

Если в выводе PHP-скрипта отображаются кракозябры (например, вместо русских букв), необходимо убедиться, что файл сохранён в UTF-8 без BOM. В VS Code строка состояния показывает кодировку; кликните по ней и выберите Save with Encoding -> UTF-8. В PHP-коде явно укажите заголовок:

header('Content-Type: text/html; charset=utf-8');
echo 'Привет, мир!';

В PhpStorm автоматическая конвертация: Settings -> Editor -> File Encodings -> Project Encoding = UTF-8. Для Sublime Text установите пакет ConvertToUTF8.

6. Использование PHP Server в VS Code для мгновенного предпросмотра

Расширение PHP Server запускает встроенный PHP-сервер (php -S) и открывает браузер. Настройка (settings.json):

{
    "php-server.documentRoot": "${workspaceFolder}/public",
    "php-server.port": 8080
}

При открытии скрипта и нажатии Ctrl+F5 редактор запускает сервер, выводит в терминал адрес. Пример вывода:

PHP 8.2.5 Development Server (http://localhost:8080) started

В браузере по адресу http://localhost:8080/index.php отображается страница. Эта команда удобна для быстрой проверки без Docker или Apache.

7. Интеграция с Git в PhpStorm: автоматическая проверка стиля коммита

Настройте Git-хук, вызывающий PHP CS Fixer перед созданием коммита. В корне проекта создайте файл .git/hooks/pre-commit (исполняемый):

#!/bin/bash
php vendor/bin/php-cs-fixer fix --diff --dry-run .
if [ $? -ne 0 ]; then
    echo "Code style violations found, commit aborted."
    exit 1
fi

Если PhpStorm настроен на использование внешних инструментов, он также подхватит этот хук. Пример результата при нарушении:

...
------------
FIXED FILES:
------------
1) /path/to/file.php (braces, braces_position)

Fixed 1 file.

Code style violations found, commit aborted.