Привет, коллеги!
Решил организовать небольшую рубрику с новостями по проекту Boson PHP. Вкратце о проекте, для тех, кто не в курсе.

Boson PHP — это платформа для создания кроссплатформенных настольных приложений, которая позволяет использовать веб-технологии (PHP, JavaScript, HTML, CSS) для создания native-приложений. Она сочетает в себе интерпретатор PHP и движок WebView, что позволяет собирать приложения в единый исполняемый файл для Windows, Linux и macOS. Для PHP-разработчиков, желающих выйти за рамки веба и создавать кроссплатформенные приложения с использованием знакомого стека технологий. Его ключевые преимущества — легкость, производительность и простота.

Хедлайнер проекта Кирилл Несмеянов, ну а коллектив разработчиков: Алексей Гагарин, Дмитрий Дерепко и я (Данил Щуцкий) помогаем ему.

20 августа состоялся второй стрим по Boson PHP. Расскажу вкратце, что там было интересного. За 4 месяца с момента предыдущего прямого эфира в проекте произошло много изменений:

Запуск нового лендинга bosonphp.com

Последний месяц команда работала над новым лендингом, который зарелизили в прямом эфире. Весь лендинг создан с использованием веб-компонентов (основа Boson). Верстая лендинг чуть не надорвался @krvvko, спасибо ему за работу!

Новая документация

• Переход с JetBrains WriterSite на собственное решение — предыдущая система была не очень удобна для версионирования и переводов. Делали лендинг, решили заодно создать и движок документации

• Версионирование документации — доступны версии 15, 16, 17 и master с возможностью переключения

• Четкое разделение по разделам:

  • Application — общие вопросы приложения

  • Windows — управление окнами

  • WebView — веб-интерфейс и компоненты

  • Deployment — компиляция и сборка

Демонстрация веб-компонентов

Значительная часть стрима была посвящена детальной демонстрации веб-компонентов — главной особенности Boson, которые используют нативные возможности браузеров вместо виртуального DOM. Давайте разберемся на примерах, как это работает.

Создаем свой первый компонент

Все просто — регистрируем компонент и используем. Главное правило: в названии тега должен быть дефис!

class MyAwesomeButton {}

$app = new Boson\Application();

// Tag component name
$tag = 'my-button';

// Component class name
$component = MyAwesomeButton::class;

$app->webview->components->add('my-button', MyAwesomeButton::class);
$app->webview->html = '<my-button>Нажми меня!</my-button>';

Делаем шаблоны

Обычный HTML-шаблон

Хотите кастомный внешний вид? Легко!

class MyAwesomeButton implements HasTemplateInterface {
    public function render(): string {
        return '<button class="fancy-btn">? Крутая кнопка! ?</button>';
    }
}

Shadow DOM — для продвинутых

Shadow DOM изолирует ваши стили и добавляет поддержку слотов:

class MyCard implements HasShadowDomInterface {
    public function render(): string {
        return '
            <div class="card">
                <h3>Заголовок карточки</h3>
                <slot></slot> <!-- Сюда попадет содержимое -->
            </div>
        ';
    }
}

Следим за жизненным циклом

Хотите знать, когда ваш компонент появился или исчез со страницы?

class MyComponent implements HasLifecycleCallbacksInterface {
    public function onConnect(): void {
        echo "Привет! Я появился на странице! ?";
    }
    
    public function onDisconnect(): void {
        echo "Пока! Меня удалили ?";
    }
}

Добавляем интерактивность

Свойства — данные из JavaScript

Отслеживаем, когда JS меняет свойства компонента:

class Counter implements HasPropertiesInterface {
    public function onPropertyChanged(string $property, mixed $value): void {
        if ($property === 'count') {
            echo "Счетчик изменился! Новое значение: $value";
        }
    }
    
    public static function getPropertyNames(): array {
        return ['count']; // Следим за свойством count
    }
}

// В JavaScript
let counter = document.createElement('my-counter');
counter.count = 42; // PHP получит уведомление!

Методы — вызываем PHP из JavaScript

Самое интересное! Можно вызывать PHP-методы прямо из браузера:

class Calculator implements HasMethodsInterface {
    public function onMethodCalled(string $method, array $args = []): mixed {
        switch ($method) {
            case 'add':
                return $args[0] + $args[1];
            case 'greet':
                return "Привет из PHP! ?";
            default:
                throw new \BadMethodCallException("Метод $method не найден");
        }
    }
    
    public static function getMethodNames(): array {
        return ['add', 'greet'];
    }
}

<!-- В HTML -->
<my-calculator onclick="this.greet()">Калькулятор</my-calculator>

// Или асинхронно из JS
const calc = document.createElement('my-calculator');
let result = await calc.add(5, 3); // Вернет 8!

Атрибуты — реагируем на изменения HTML

Следим за изменениями атрибутов в реальном времени:

class StatusBadge implements HasAttributesInterface {
    public function onAttributeChanged(string $attribute, ?string $value, ?string $previous): void {
        if ($attribute === 'status') {
            if ($value === null) {
                echo "Статус удален!";
            } elseif ($previous === null) {
                echo "Добавлен статус: $value";
            } else {
                echo "Статус изменен с '$previous' на '$value'";
            }
        }
    }
    
    public static function getAttributeNames(): array {
        return ['status', 'priority'];
    }
}

События — обрабатываем клики и прочее

Ловим события браузера в PHP:

class InteractiveWidget implements HasEventListenersInterface {
    public function onEventFired(string $event, array $args = []): void {
        if ($event === 'click') {
            $x = $args['x'];
            $y = $args['y'];
            echo "Кликнули по координатам: $x, $y";
        }
    }
    
    public static function getEventListeners(): array {
        return [
            'click' => [
                'x' => 'clientX',  // Переименовываем clientX в x
                'y' => 'clientY'   // Переименовываем clientY в y
            ],
        ];
    }
}

Реактивный контекст — управляем компонентом

Это ваш главный инструмент для программного управления компонентом:

use Boson\WebView\Api\WebComponents\ReactiveContext;

class SmartComponent implements HasMethodsInterface {
    public function __construct(private ReactiveContext $ctx) {}
    
    public function refresh(): void {
        // Проверяем атрибуты
        if (!$this->ctx->attributes->has('loaded')) {
            $this->ctx->attributes->set('loaded', 'true');
        }
        
        // Меняем содержимое
        if ($this->ctx->content->html === '') {
            $this->ctx->content->html = '<p>Контент загружен! ✅</p>';
        }
    }
    
    public function onMethodCalled(string $method, array $args = []): mixed {
        if ($method === 'refresh') {
            $this->refresh();
            return 'Обновлено!';
        }
    }
    
    public static function getMethodNames(): array {
        return ['refresh'];
    }
}

В документации можно изучить подробнее.

И помните: с Boson Web Components вы получаете всю мощь серверного PHP прямо в браузерных компонентах!

Демонстрация реального приложения: HappyWife HappyLife

Алексей Гагарин на стриме продемонстрировал своё приложение — систему с LLM-агентами для "спасения жизни мужиков", как он это назвал.

Изначальная архитектура: “обычное Spiral-приложение” на Roadrunner и FPM со стандартным веб-интерфейсом. Для создания приложения на Boson PHP потребовалось добавить только один файл — Boson bootloader из spiral-bridge пакета. Никаких изменений в коде — приложение заработало сразу.

В ходе тестирования приложения поняли, что для полного счастья не хватает:

• WebSockets/Server-Sent Events — для real-time взаимодействия

• Унифицированное API — одинаковый интерфейс для PHPS, Roadrunner и Boson

• Стримовые ответы — для потокового вывода токенов от LLM

Технические детали архитектуры

Реактивность под капотом: как это работает изнутри

Кирилл подробно объяснил архитектуру системы и её особенности:

• Единый процесс - PHP и WebView работают в одном процессе, общение между ними через shared memory без дополнительных накладных расходов.

• API интеграция. Используется WebKit API и Blink API верхнего уровня. Вызовы проходят напрямую (в обход промежуточных слоев), а события DOM передаются напрямую в PHP-коллбеки.

• Производительность. Позволяет выполнять ~100 тысяч операций в секунду, но есть узкое место — JSON encode/decode для сложных объектов

Операционные системы

Windows. Самая любимая у Boson PHP по состоянию на сегодняшний день:

• Использует Edge WebView2 — самый стабильный движок

• Сборка работает "из коробки" без дополнительных настроек

• Есть проблема — готовый .exe имеет логотип PHP и метаданные от оригинального интерпретатора! Но есть план как победить это - требует патчинг COFF-файлов для замены иконки и версионной информации.

Linux. Работает, но с нюансами.

• Проблемы с системами безопасности (AppArmor)

• Не все дистрибутивы одинаково поддерживают WebKitGTK. Продумываются обходные пути: запуск в контейнере или отключение ограничений

macOS. Замыкает тройку лидеров.

• Safari "не лучший браузер во вселенной" для таких задач

• Полная поломка с Revolt — event loop не работает в принципе "На macOS даже простые вещи не работают. Revolt нарушает традиционные ценности macOS, его любовь к простоте и удобству" Отставание этой платфомы объясняется отсутствием у Кирилла устройства Mac для разработки (уже пофикшено и Кирилл купил себе для работы по Boson PHP).

Расширенная интеграция с PHP фреймворками

Уже реализованы:

• Laravel: полноценный service provider

• Symfony: готовый bundle

• Spiral: встроенная интеграция

• PSR-совместимые: через HTTP-мост

Размер и производительность: конкретные цифры

Сравнили Boson PHP и Native PHP. Как вы догадались Boson в руках своего автора не оставил шансов конкуренту - в разы легче и быстрее, как и написано на лендинге. Но всё равно есть куда стремиться и уже намечены еще варианты по дальнейшей оптимизации.

Ссылка на стрим:

Будущее проекта: планы и ожидания

Архитектурные улучшения

• Система плагинов — вынос Network API, Battery API в отдельные расширения

• Избежание конфликтов — не использовать существующие DI-контейнеры

• Модульность — возможность включать в сборку только нужные компоненты

Ожидание релиза Saucer v7, обновления библиотеки для отображения WebView внутри нативных приложений. В нём ожидается:

• Решение проблем с памятью — исправление багов PHP FFI с указателями

• Нативные хендлы — прямой доступ к платформенным API

• Новые возможности — камера, геолокация, нотификации через OS API

Boson PHP развивается! Приглашаю участвовать в разработке и тестировании. Присоединяйтесь!

• Telegram-чат: https://t.me/boson_php

• Discord: https://discord.gg/vCg52Jdwvc

• GitHub: https://github.com/boson-php

• Официальный сайт: https://bosonphp.com

• Документация: https://bosonphp.com/doc/0.17/introduction