Pulse Boson PHP #1 - Murat Piakartov

Привет, коллеги!
Решил организовать небольшую рубрику с новостями по проекту 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 <<<HTML
            <button class="fancy-btn">🎉 Крутая кнопка! 🎉</button>
        HTML;
    }
}

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

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

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

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

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

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 'Обновлено!';
        }
        
        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 в руках своего автора не оставил шансов конкуренту — в разы легче и быстрее, как и написано на лендинге. Но всё равно есть куда стремиться и уже намечены еще варианты по дальнейшей оптимизации.

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

Before you continue to YouTube

consent.youtube.com

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

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

Система плагинов — вынос 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

Источник: https://habr.com/ru/articles/944716/