@@ -14,23 +14,61 @@
-DLoad упрощает загрузку и управление бинарными артефактами для ваших проектов. Идеально подходит для сред разработки, которые требуют специфических инструментов, таких как RoadRunner, Temporal или пользовательские бинарные файлы.
+DLoad упрощает загрузку и управление бинарными артефактами в ваших проектах. Отлично подходит для dev-окружений, которым нужны специфические инструменты вроде RoadRunner, Temporal или собственные бинарники.
[](README.md)
[](README-zh.md)
[](README-ru.md)
[](README-es.md)
-## Почему DLoad?
+## Зачем нужен DLoad?
+
+DLoad решает распространённую проблему в PHP-проектах: как распространять и устанавливать нужные бинарные инструменты и ресурсы вместе с PHP-кодом.
-DLoad решает общую проблему в PHP-проектах: как распространять и устанавливать необходимые бинарные инструменты и ресурсы вместе с PHP-кодом.
С DLoad вы можете:
-- Автоматически загружать необходимые инструменты во время инициализации проекта
-- Обеспечить использование одинаковых версий инструментов всеми участниками команды
-- Упростить адаптацию через автоматизацию настройки окружения
-- Управлять кроссплатформенной совместимостью без ручной конфигурации
-- Хранить бинарные файлы и ресурсы отдельно от системы контроля версий
+- Автоматически скачивать необходимые инструменты при инициализации проекта
+- Обеспечить использование одинаковых версий инструментов всей командой
+- Упростить онбординг через автоматизацию настройки окружения
+- Управлять кроссплатформенной совместимостью без ручной настройки
+- Хранить бинарники и ресурсы отдельно от системы контроля версий
+
+### Содержание
+
+- [Установка](#установка)
+- [Быстрый старт](#быстрый-старт)
+- [Использование в командной строке](#использование-в-командной-строке)
+ - [Инициализация конфигурации](#инициализация-конфигурации)
+ - [Загрузка ПО](#загрузка-по)
+ - [Просмотр ПО](#просмотр-по)
+ - [Сборка кастомного ПО](#сборка-кастомного-по)
+- [Руководство по конфигурации](#руководство-по-конфигурации)
+ - [Интерактивная конфигурация](#интерактивная-конфигурация)
+ - [Ручная конфигурация](#ручная-конфигурация)
+ - [Типы загрузки](#типы-загрузки)
+ - [Ограничения версий](#ограничения-версий)
+ - [Расширенные настройки](#расширенные-настройки)
+- [Сборка кастомного RoadRunner](#сборка-кастомного-roadrunner)
+ - [Настройка действия сборки](#настройка-действия-сборки)
+ - [Атрибуты Velox-действия](#атрибуты-velox-действия)
+ - [Процесс сборки](#процесс-сборки)
+ - [Генерация конфигурационного файла](#генерация-конфигурационного-файла)
+ - [Использование скачанного Velox](#использование-скачанного-velox)
+ - [Конфигурация DLoad](#конфигурация-dload)
+ - [Сборка RoadRunner](#сборка-roadrunner)
+- [Пользовательский реестр ПО](#пользовательский-реестр-по)
+ - [Определение ПО](#определение-по)
+ - [Элементы ПО](#элементы-по)
+- [Сценарии использования](#сценарии-использования)
+ - [Настройка среды разработки](#настройка-среды-разработки)
+ - [Настройка нового проекта](#настройка-нового-проекта)
+ - [Интеграция с CI/CD](#интеграция-с-cicd)
+ - [Кроссплатформенные команды](#кроссплатформенные-команды)
+ - [Управление PHAR-инструментами](#управление-phar-инструментами)
+ - [Распространение фронтенд-ресурсов](#распространение-фронтенд-ресурсов)
+- [Ограничения GitHub API](#ограничения-github-api)
+- [Участие в разработке](#участие-в-разработке)
+
## Установка
@@ -51,18 +89,21 @@ composer require internal/dload -W
composer require internal/dload -W
```
-2. **Создайте файл конфигурации интерактивно**:
+Альтернативно можно скачать последний релиз с [GitHub releases](https://github.com/php-internal/dload/releases).
+
+2. **Создайте конфигурационный файл интерактивно**:
```bash
./vendor/bin/dload init
```
- Эта команда проведет вас через выбор пакетов ПО и создаст файл конфигурации `dload.xml`. Вы также можете создать его вручную:
+ Эта команда проведёт вас через выбор пакетов ПО и создаст файл конфигурации `dload.xml`. Можно также создать его вручную:
```xml
+ xsi:noNamespaceSchemaLocation="https://raw.githubusercontent.com/php-internal/dload/refs/heads/1.x/dload.xsd"
+ >
@@ -70,34 +111,34 @@ composer require internal/dload -W
```
-3. **Загрузите настроенное ПО**:
+3. **Скачайте настроенное ПО**:
```bash
./vendor/bin/dload get
```
-4. **Интеграция с Composer** (опционально):
+4. **Интегрируйте с Composer** (опционально):
```json
{
"scripts": {
- "post-update-cmd": "dload get --no-interaction -v || echo can't dload binaries"
+ "post-update-cmd": "dload get --no-interaction -v || \"echo can't dload binaries\""
}
}
```
-## Использование командной строки
+## Использование в командной строке
### Инициализация конфигурации
```bash
-# Создать файл конфигурации интерактивно
+# Создать конфигурационный файл интерактивно
./vendor/bin/dload init
-# Создать конфигурацию в определенном месте
+# Создать конфигурацию в определённом месте
./vendor/bin/dload init --config=./custom-dload.xml
-# Создать минимальную конфигурацию без подсказок
+# Создать минимальную конфигурацию без запросов
./vendor/bin/dload init --no-interaction
# Перезаписать существующую конфигурацию без подтверждения
@@ -107,63 +148,82 @@ composer require internal/dload -W
### Загрузка ПО
```bash
-# Загрузить из файла конфигурации
+# Загрузить из конфигурационного файла
./vendor/bin/dload get
-# Загрузить определенные пакеты
+# Загрузить конкретные пакеты
./vendor/bin/dload get rr temporal
-# Загрузить с опциями
+# Загрузить с дополнительными опциями
./vendor/bin/dload get rr --stability=beta --force
```
#### Опции загрузки
| Опция | Описание | По умолчанию |
-|--------|-------------|---------|
-| `--path` | Директория для хранения бинарных файлов | Текущая директория |
+|-------|----------|--------------|
+| `--path` | Папка для хранения бинарников | Текущая папка |
| `--arch` | Целевая архитектура (amd64, arm64) | Архитектура системы |
| `--os` | Целевая ОС (linux, darwin, windows) | Текущая ОС |
| `--stability` | Стабильность релиза (stable, beta) | stable |
-| `--config` | Путь к файлу конфигурации | ./dload.xml |
-| `--force`, `-f` | Принудительная загрузка даже если бинарный файл существует | false |
+| `--config` | Путь к конфигурационному файлу | ./dload.xml |
+| `--force`, `-f` | Принудительная загрузка даже если бинарник уже есть | false |
### Просмотр ПО
```bash
-# Вывести список доступных пакетов ПО
+# Показать доступные пакеты ПО
./vendor/bin/dload software
# Показать загруженное ПО
./vendor/bin/dload show
-# Показать детали определенного ПО
+# Показать детали конкретного ПО
./vendor/bin/dload show rr
-# Показать все ПО (загруженное и доступное)
+# Показать всё ПО (загруженное и доступное)
./vendor/bin/dload show --all
```
+### Сборка кастомного ПО
+
+```bash
+# Собрать кастомное ПО используя конфигурационный файл
+./vendor/bin/dload build
+
+# Собрать с определённым конфигурационным файлом
+./vendor/bin/dload build --config=./custom-dload.xml
+```
+
+#### Опции сборки
+
+| Опция | Описание | По умолчанию |
+|-------|----------|--------------|
+| `--config` | Путь к конфигурационному файлу | ./dload.xml |
+
+Команда `build` выполняет действия сборки, определённые в вашем конфигурационном файле, например создание кастомных бинарников RoadRunner с определёнными плагинами.
+Подробную информацию о сборке кастомного RoadRunner смотрите в разделе [Сборка кастомного RoadRunner](#сборка-кастомного-roadrunner).
+
## Руководство по конфигурации
### Интерактивная конфигурация
-Самый простой способ создать файл конфигурации - использовать интерактивную команду `init`:
+Простейший способ создать конфигурационный файл — использовать интерактивную команду `init`:
```bash
./vendor/bin/dload init
```
-Это:
+Она:
-- Проведет вас через выбор пакетов ПО
+- Проведёт вас через выбор пакетов ПО
- Покажет доступное ПО с описаниями и репозиториями
-- Создаст правильно отформатированный файл `dload.xml` с валидацией схемы
-- Корректно обработает существующие файлы конфигурации
+- Сгенерирует правильно отформатированный файл `dload.xml` с валидацией схемы
+- Аккуратно обработает существующие конфигурационные файлы
### Ручная конфигурация
-Создайте `dload.xml` в корне вашего проекта:
+Создайте `dload.xml` в корне проекта:
```xml
@@ -180,51 +240,51 @@ composer require internal/dload -W
### Типы загрузки
-DLoad поддерживает три типа загрузки, которые определяют, как обрабатываются ресурсы:
+DLoad поддерживает три типа загрузки, которые определяют способ обработки ресурсов:
#### Атрибут типа
```xml
-
-
-
+
+
+
-
+
```
#### Поведение по умолчанию (тип не указан)
-Когда `type` не указан, DLoad автоматически использует все доступные обработчики:
+Когда `type` не указан, DLoad автоматически применяет все доступные обработчики:
-- **Обработка бинарных файлов**: Если у ПО есть секция `
`, выполняет проверку наличия и версии бинарного файла
+- **Обработка бинарников**: Если у ПО есть секция ``, выполняет проверку наличия и версии бинарника
- **Обработка файлов**: Если у ПО есть секция `` и ресурс загружен, обрабатывает файлы во время распаковки
- **Простая загрузка**: Если секций нет, загружает ресурс без распаковки
```xml
-
+
-
-
+
+
```
-#### Поведение явных типов
+#### Поведение при явном указании типа
-| Тип | Поведение | Случай использования |
-|-----------|--------------------------------------------------------------|--------------------------------|
-| `binary` | Проверка бинарных файлов, валидация версии, права на выполнение | CLI инструменты, исполняемые файлы |
-| `phar` | Загружает `.phar` файлы как исполняемые **без распаковки** | PHP инструменты как Psalm, PHPStan |
-| `archive` | **Принудительная распаковка даже для .phar файлов** | Когда нужно содержимое архива |
+| Тип | Поведение | Случаи использования |
+|-----------|----------------------------------------------------------------|--------------------------------|
+| `binary` | Проверка бинарника, валидация версии, права на выполнение | CLI-инструменты, исполняемые файлы |
+| `phar` | Загружает `.phar` файлы как исполняемые **без распаковки** | PHP-инструменты вроде Psalm, PHPStan |
+| `archive` | **Принудительно распаковывает даже .phar файлы** | Когда нужно содержимое архива |
> [!NOTE]
-> Используйте `type="phar"` для PHP инструментов, которые должны остаться `.phar` файлами.
+> Используйте `type="phar"` для PHP-инструментов, которые должны остаться как `.phar` файлы.
> Использование `type="archive"` распакует даже `.phar` архивы.
### Ограничения версий
@@ -236,34 +296,131 @@ DLoad поддерживает три типа загрузки, которые
-
+
-
+
```
-### Расширенные опции конфигурации
+### Расширенные настройки
```xml
-
+
-
+
```
+## Сборка кастомного RoadRunner
+
+DLoad поддерживает сборку кастомных бинарников RoadRunner с помощью инструмента сборки Velox. Это полезно когда нужен RoadRunner с определёнными комбинациями плагинов, которые недоступны в готовых релизах.
+
+### Настройка действия сборки
+
+```xml
+
+
+
+
+
+
+
+```
+
+### Атрибуты Velox-действия
+
+| Атрибут | Описание |
+|---------|----------|
+| `velox-version` | Ограничение версии для используемого инструмента сборки Velox |
+| `golang-version` | Ограничение версии Go, необходимой для сборки RoadRunner |
+| `roadrunner-ref` | Git-ссылка RoadRunner (тег, коммит или ветка), используемая как основа для сборки |
+| `config-file` | Путь к базовому конфигурационному файлу, который может объединяться с ответами удаленного API или другими источниками |
+| `binary-path` | Путь вывода для собранного бинарника RoadRunner. Расширение файла автоматически добавляется в зависимости от ОС (`.exe` для Windows). По умолчанию используется текущий рабочий каталог |
+| `debug` | Собрать RoadRunner с отладочными символами для профилирования с помощью pprof (логическое значение, по умолчанию `false`) |
+
+### Процесс сборки
+
+DLoad автоматически управляет процессом сборки:
+
+1. **Проверка Golang**: Проверяет что Go установлен глобально (обязательная зависимость)
+2. **Подготовка Velox**: Использует Velox из глобальной установки, локальной загрузки или автоматически скачивает при необходимости
+3. **Конфигурация**: Копирует ваш локальный velox.toml в папку сборки
+4. **Сборка**: Выполняет команду `vx build` с указанной конфигурацией
+5. **Установка**: Перемещает собранный бинарник в целевое расположение и устанавливает права на выполнение
+6. **Очистка**: Удаляет временные файлы сборки
+
+> [!NOTE]
+> DLoad требует чтобы Go (Golang) был установлен глобально в вашей системе. Он не скачивает и не управляет установками Go.
+
+### Генерация конфигурационного файла
+
+Можно сгенерировать файл конфигурации `velox.toml` с помощью онлайн-билдера на https://build.roadrunner.dev/
+
+Подробную документацию по опциям конфигурации Velox и примерам смотрите на https://docs.roadrunner.dev/docs/customization/build
+
+Этот веб-интерфейс помогает выбрать плагины и генерирует подходящую конфигурацию для вашей кастомной сборки RoadRunner.
+
+### Использование скачанного Velox
+
+Можно скачать Velox как часть процесса сборки вместо использования глобально установленной версии:
+
+```xml
+
+
+
+
+```
+
+Это обеспечивает консистентные версии Velox в разных окружениях и между участниками команды.
+
+### Конфигурация DLoad
+
+```xml
+
+
+
+
+
+
+```
+
+### Сборка RoadRunner
+
+```bash
+# Собрать RoadRunner используя конфигурацию velox.toml
+./vendor/bin/dload build
+
+# Собрать с определённым конфигурационным файлом
+./vendor/bin/dload build --config=custom-rr.xml
+```
+
+Собранный бинарник RoadRunner будет включать только плагины, указанные в вашем файле `velox.toml`, что уменьшает размер бинарника и улучшает производительность для вашего конкретного случая использования.
+
## Пользовательский реестр ПО
### Определение ПО
@@ -271,7 +428,7 @@ DLoad поддерживает три типа загрузки, которые
```xml
-
+
@@ -280,13 +437,13 @@ DLoad поддерживает три типа загрузки, которые
-
+
-
+
@@ -294,7 +451,7 @@ DLoad поддерживает три типа загрузки, которые
-
+
@@ -309,21 +466,21 @@ DLoad поддерживает три типа загрузки, которые
- **type**: В настоящее время поддерживает "github"
- **uri**: Путь репозитория (например, "username/repo")
-- **asset-pattern**: Шаблон регулярного выражения для сопоставления ресурсов релиза
+- **asset-pattern**: Regex-паттерн для соответствия ресурсам релиза
-#### Элементы бинарных файлов
+#### Элементы Binary
-- **name**: Имя бинарного файла для ссылки
-- **pattern**: Шаблон регулярного выражения для сопоставления бинарного файла в ресурсах
+- **name**: Имя бинарника для ссылки
+- **pattern**: Regex-паттерн для соответствия бинарнику в ресурсах
- Автоматически обрабатывает фильтрацию по ОС/архитектуре
-#### Элементы файлов
+#### Элементы File
-- **pattern**: Шаблон регулярного выражения для сопоставления файлов
-- **extract-path**: Необязательная директория извлечения
+- **pattern**: Regex-паттерн для соответствия файлам
+- **extract-path**: Опциональная папка извлечения
- Работает на любой системе (без фильтрации по ОС/архитектуре)
-## Случаи использования
+## Сценарии использования
### Настройка среды разработки
@@ -344,7 +501,7 @@ composer require internal/dload -W
./vendor/bin/dload get
```
-### Интеграция CI/CD
+### Интеграция с CI/CD
```yaml
# GitHub Actions
@@ -354,29 +511,29 @@ composer require internal/dload -W
### Кроссплатформенные команды
-Каждый разработчик получает правильные бинарные файлы для своей системы:
+Каждый разработчик получает правильные бинарники для своей системы:
```xml
-
-
+
+
```
-### Управление PHAR инструментами
+### Управление PHAR-инструментами
```xml
-
+
-
+
```
-### Распространение фронтенд ресурсов
+### Распространение фронтенд-ресурсов
```xml
@@ -389,9 +546,9 @@ composer require internal/dload -W
```
-## Ограничения API GitHub
+## Ограничения GitHub API
-Используйте персональный токен доступа, чтобы избежать ограничений скорости:
+Используйте персональный токен доступа чтобы избежать ограничений:
```bash
GITHUB_TOKEN=your_token_here ./vendor/bin/dload get
@@ -399,10 +556,10 @@ GITHUB_TOKEN=your_token_here ./vendor/bin/dload get
Добавьте в переменные окружения CI/CD для автоматических загрузок.
-## Вклад в проект
+## Участие в разработке
-Вклады приветствуются! Отправляйте Pull Request для:
+Участие приветствуется! Отправляйте Pull Request'ы для:
-- Добавления нового ПО в предопределенный реестр
-- Улучшения функциональности DLoad
-- Улучшения документации и ее перевода на [другие языки](docs/guidelines/how-to-translate-readme-docs.md)
+- Добавления нового ПО в предопределённый реестр
+- Улучшения функциональности DLoad
+- Улучшения документации и перевода на [другие языки](docs/guidelines/how-to-translate-readme-docs.md)
diff --git a/README-zh.md b/README-zh.md
index e27cfb8..668279b 100644
--- a/README-zh.md
+++ b/README-zh.md
@@ -14,7 +14,7 @@
-DLoad 简化了为您的项目下载和管理二进制工件的过程。非常适合需要特定工具（如 RoadRunner、Temporal 或自定义二进制文件）的开发环境。
+DLoad 让项目中的二进制工件下载和管理变得简单轻松。它特别适合那些需要特定工具的开发环境，比如 RoadRunner、Temporal 或者自定义二进制文件。
[](README.md)
[](README-zh.md)
@@ -23,14 +23,51 @@ DLoad 简化了为您的项目下载和管理二进制工件的过程。非常
## 为什么选择 DLoad？
-DLoad 解决了 PHP 项目中的一个常见问题：如何在 PHP 代码的同时分发和安装必要的二进制工具和资产。
-使用 DLoad，您可以：
+DLoad 解决了 PHP 项目中的一个实际问题：如何在分发 PHP 代码的同时，有效地分发和安装必要的二进制工具和资产。
+通过 DLoad，你可以：
+
+- 在项目初始化时自动下载所需工具
+- 确保团队所有成员都用相同版本的工具
+- 通过自动化环境配置简化新人入职流程
+- 无需手动配置就能管理跨平台兼容性
+- 让二进制文件和资产与版本控制保持分离
+
+### 目录
+
+- [安装](#安装)
+- [快速上手](#快速上手)
+- [命令行使用](#命令行使用)
+ - [初始化配置](#初始化配置)
+ - [下载软件](#下载软件)
+ - [查看软件](#查看软件)
+ - [构建自定义软件](#构建自定义软件)
+- [配置指南](#配置指南)
+ - [交互式配置](#交互式配置)
+ - [手动配置](#手动配置)
+ - [下载类型](#下载类型)
+ - [版本约束](#版本约束)
+ - [高级配置选项](#高级配置选项)
+- [构建自定义 RoadRunner](#构建自定义-roadrunner)
+ - [构建动作配置](#构建动作配置)
+ - [Velox 动作属性](#velox-动作属性)
+ - [构建流程](#构建流程)
+ - [配置文件生成](#配置文件生成)
+ - [使用下载的 Velox](#使用下载的-velox)
+ - [DLoad 配置](#dload-配置)
+ - [构建 RoadRunner](#构建-roadrunner)
+- [自定义软件注册表](#自定义软件注册表)
+ - [定义软件](#定义软件)
+ - [软件要素](#软件要素)
+- [使用场景](#使用场景)
+ - [开发环境配置](#开发环境配置)
+ - [新项目创建](#新项目创建)
+ - [CI/CD 集成](#cicd-集成)
+ - [跨平台团队协作](#跨平台团队协作)
+ - [PHAR 工具管理](#phar-工具管理)
+ - [前端资源分发](#前端资源分发)
+- [GitHub API 速率限制](#github-api-速率限制)
+- [参与贡献](#参与贡献)
-- 在项目初始化期间自动下载所需工具
-- 确保所有团队成员使用相同版本的工具
-- 通过自动化环境设置简化新人入职
-- 管理跨平台兼容性，无需手动配置
-- 将二进制文件和资产与版本控制分开
## 安装
@@ -43,7 +80,7 @@ composer require internal/dload -W
[](LICENSE.md)
[](https://packagist.org/packages/internal/dload/stats)
-## 快速开始
+## 快速上手
1. **通过 Composer 安装 DLoad**：
@@ -51,18 +88,21 @@ composer require internal/dload -W
composer require internal/dload -W
```
+ 你也可以从 [GitHub 发布页面](https://github.com/php-internal/dload/releases) 下载最新版本。
+
2. **交互式创建配置文件**：
```bash
./vendor/bin/dload init
```
- 此命令将指导您选择软件包并创建 `dload.xml` 配置文件。您也可以手动创建：
+ 这个命令会引导你选择软件包，并创建一个 `dload.xml` 配置文件。当然，你也可以手动创建：
```xml
+ xsi:noNamespaceSchemaLocation="https://raw.githubusercontent.com/php-internal/dload/refs/heads/1.x/dload.xsd"
+ >
@@ -70,7 +110,7 @@ composer require internal/dload -W
```
-3. **下载配置的软件**：
+3. **下载配置好的软件**：
```bash
./vendor/bin/dload get
@@ -81,7 +121,7 @@ composer require internal/dload -W
```json
{
"scripts": {
- "post-update-cmd": "dload get --no-interaction -v || echo can't dload binaries"
+ "post-update-cmd": "dload get --no-interaction -v || \"echo can't dload binaries\""
}
}
```
@@ -97,41 +137,41 @@ composer require internal/dload -W
# 在指定位置创建配置
./vendor/bin/dload init --config=./custom-dload.xml
-# 创建最小配置，无提示
+# 无提示创建最简配置
./vendor/bin/dload init --no-interaction
-# 覆盖现有配置而不确认
+# 不经确认就覆盖现有配置
./vendor/bin/dload init --overwrite
```
### 下载软件
```bash
-# 从配置文件下载
+# 根据配置文件下载
./vendor/bin/dload get
-# 下载特定包
+# 下载指定软件包
./vendor/bin/dload get rr temporal
-# 使用选项下载
+# 带选项下载
./vendor/bin/dload get rr --stability=beta --force
```
#### 下载选项
-| 选项 | 描述 | 默认值 |
+| 选项 | 说明 | 默认值 |
|--------|-------------|---------|
-| `--path` | 存储二进制文件的目录 | 当前目录 |
+| `--path` | 二进制文件存储目录 | 当前目录 |
| `--arch` | 目标架构 (amd64, arm64) | 系统架构 |
| `--os` | 目标操作系统 (linux, darwin, windows) | 当前操作系统 |
| `--stability` | 发布稳定性 (stable, beta) | stable |
| `--config` | 配置文件路径 | ./dload.xml |
-| `--force`, `-f` | 即使二进制文件存在也强制下载 | false |
+| `--force`, `-f` | 即使二进制文件已存在也强制下载 | false |
### 查看软件
```bash
-# 列出可用的软件包
+# 列出可用软件包
./vendor/bin/dload software
# 显示已下载的软件
@@ -144,21 +184,40 @@ composer require internal/dload -W
./vendor/bin/dload show --all
```
+### 构建自定义软件
+
+```bash
+# 使用配置文件构建自定义软件
+./vendor/bin/dload build
+
+# 使用特定配置文件构建
+./vendor/bin/dload build --config=./custom-dload.xml
+```
+
+#### 构建选项
+
+| 选项 | 说明 | 默认值 |
+|--------|-------------|---------|
+| `--config` | 配置文件路径 | ./dload.xml |
+
+`build` 命令会执行配置文件中定义的构建动作，比如创建带有特定插件的自定义 RoadRunner 二进制文件。
+想了解构建自定义 RoadRunner 的详细信息，请查看 [构建自定义 RoadRunner](#构建自定义-roadrunner) 部分。
+
## 配置指南
### 交互式配置
-创建配置文件的最简单方法是使用交互式 `init` 命令：
+创建配置文件最简单的方式就是使用交互式 `init` 命令：
```bash
./vendor/bin/dload init
```
-这将：
+这个命令会：
-- 指导您选择软件包
-- 显示可用软件及其描述和仓库
-- 生成格式正确的 `dload.xml` 文件并进行模式验证
+- 引导你选择软件包
+- 显示可用软件及其说明和仓库信息
+- 生成格式正确并带有模式验证的 `dload.xml` 文件
- 优雅地处理现有配置文件
### 手动配置
@@ -180,28 +239,28 @@ composer require internal/dload -W
### 下载类型
-DLoad 支持三种下载类型，决定资产的处理方式：
+DLoad 支持三种下载类型，它们决定了资源的处理方式：
#### 类型属性
```xml
-
+
-
-
+
+
-
+
```
#### 默认行为（未指定类型）
-当未指定 `type` 时，DLoad 自动使用所有可用的处理器：
+当没有指定 `type` 时，DLoad 会自动使用所有可用的处理器：
-- **二进制处理**：如果软件有 `` 部分，执行二进制存在性和版本检查
-- **文件处理**：如果软件有 `` 部分且资产已下载，在解包期间处理文件
-- **简单下载**：如果没有部分存在，下载资产而不解包
+- **二进制处理**：如果软件有 `` 部分，会进行二进制存在性和版本检查
+- **文件处理**：如果软件有 `` 部分且资源已下载，会在解包时处理文件
+- **简单下载**：如果没有任何部分，则下载资源但不解包
```xml
@@ -210,26 +269,26 @@ DLoad 支持三种下载类型，决定资产的处理方式：
-
-
+
+
```
-#### 显式类型行为
+#### 明确类型的行为
-| 类型 | 行为 | 用例 |
+| 类型 | 行为 | 适用场景 |
|-----------|--------------------------------------------------------------|--------------------------------|
| `binary` | 二进制检查、版本验证、可执行权限 | CLI 工具、可执行文件 |
-| `phar` | 下载 `.phar` 文件作为可执行文件**而不解包** | PHP 工具如 Psalm、PHPStan |
-| `archive` | **强制解包即使是 .phar 文件** | 当您需要归档内容时 |
+| `phar` | 下载 `.phar` 文件作为可执行文件**但不解包** | PHP 工具如 Psalm、PHPStan |
+| `archive` | **强制解包即使是 .phar 文件** | 当你需要压缩包内容时 |
> [!NOTE]
-> 对于应保持为 `.phar` 文件的 PHP 工具，使用 `type="phar"`。
-> 使用 `type="archive"` 将解包甚至 `.phar` 归档。
+> 对于应该保持为 `.phar` 文件的 PHP 工具，使用 `type="phar"`。
+> 使用 `type="archive"` 会解包甚至 `.phar` 压缩包。
### 版本约束
-使用 Composer 风格的版本约束：
+使用类似 Composer 的版本约束：
```xml
@@ -243,7 +302,7 @@ DLoad 支持三种下载类型，决定资产的处理方式：
-
+
```
@@ -253,7 +312,7 @@ DLoad 支持三种下载类型，决定资产的处理方式：
```xml
-
+
@@ -264,6 +323,103 @@ DLoad 支持三种下载类型，决定资产的处理方式：
```
+## 构建自定义 RoadRunner
+
+DLoad 支持使用 Velox 构建工具来构建自定义 RoadRunner 二进制文件。当你需要包含特定插件组合的 RoadRunner，而这些组合在预构建版本中不可用时，这功能就很有用了。
+
+### 构建动作配置
+
+```xml
+
+
+
+
+
+
+
+```
+
+### Velox 动作属性
+
+| 属性 | 说明 |
+|-----------|-------------|
+| `velox-version` | 使用的 Velox 构建工具的版本约束 |
+| `golang-version` | 构建 RoadRunner 所需的 Go 版本约束 |
+| `roadrunner-ref` | 用作构建基础的 RoadRunner Git 引用（标签、提交或分支） |
+| `config-file` | 基础配置文件路径，可能与远程 API 响应或其他源合并 |
+| `binary-path` | 构建的 RoadRunner 二进制文件输出路径。文件扩展名根据操作系统自动添加（Windows 下为 `.exe`）。默认为当前工作目录 |
+| `debug` | 使用调试符号构建 RoadRunner，以便使用 pprof 进行性能分析（布尔值，默认为 `false`） |
+
+### 构建流程
+
+DLoad 会自动处理构建过程：
+
+1. **Golang 检查**：验证 Go 是否全局安装（必需依赖）
+2. **Velox 准备**：使用全局安装的 Velox、本地下载版本，或者在需要时自动下载
+3. **配置**：将你的本地 velox.toml 复制到构建目录
+4. **构建**：使用指定配置执行 `vx build` 命令
+5. **安装**：将构建好的二进制文件移动到目标位置并设置可执行权限
+6. **清理**：删除临时构建文件
+
+> [!NOTE]
+> DLoad 需要在你的系统上全局安装 Go (Golang)。它不会下载或管理 Go 的安装。
+
+### 配置文件生成
+
+你可以使用 https://build.roadrunner.dev/ 上的在线构建器来生成 `velox.toml` 配置文件。
+
+关于 Velox 配置选项和示例的详细文档，请访问 https://docs.roadrunner.dev/docs/customization/build
+
+这个网页界面帮助你选择插件，并为你的自定义 RoadRunner 构建生成合适的配置。
+
+### 使用下载的 Velox
+
+你可以将 Velox 作为构建过程的一部分下载，而不是依赖全局安装的版本：
+
+```xml
+
+
+
+
+```
+
+这样可以确保在不同环境和团队成员之间使用一致的 Velox 版本。
+
+### DLoad 配置
+
+```xml
+
+
+
+
+
+
+```
+
+### 构建 RoadRunner
+
+```bash
+# 使用 velox.toml 配置构建 RoadRunner
+./vendor/bin/dload build
+
+# 使用特定配置文件构建
+./vendor/bin/dload build --config=custom-rr.xml
+```
+
+构建好的 RoadRunner 二进制文件只会包含你在 `velox.toml` 文件中指定的插件，这样能减少二进制文件大小并提升特定用例的性能。
+
## 自定义软件注册表
### 定义软件
@@ -279,15 +435,15 @@ DLoad 支持三种下载类型，决定资产的处理方式：
-
-
+
+
-
-
+
+
@@ -303,41 +459,41 @@ DLoad 支持三种下载类型，决定资产的处理方式：
```
-### 软件元素
+### 软件要素
#### 仓库配置
- **type**：目前支持 "github"
-- **uri**：仓库路径（例如，"username/repo"）
-- **asset-pattern**：匹配发布资产的正则表达式模式
+- **uri**：仓库路径（例如 "username/repo"）
+- **asset-pattern**：匹配发布资源的正则表达式模式
-#### 二进制元素
+#### 二进制要素
-- **name**：用于引用的二进制名称
-- **pattern**：匹配资产中二进制文件的正则表达式模式
+- **name**：用于引用的二进制文件名
+- **pattern**：匹配资源中二进制文件的正则表达式模式
- 自动处理操作系统/架构过滤
-#### 文件元素
+#### 文件要素
- **pattern**：匹配文件的正则表达式模式
-- **extract-path**：可选的提取目录
-- 在任何系统上工作（无操作系统/架构过滤）
+- **extract-path**：可选的解压目录
+- 在任何系统上都能工作（无操作系统/架构过滤）
-## 用例
+## 使用场景
-### 开发环境设置
+### 开发环境配置
```bash
-# 新开发者的一次性设置
+# 新开发者的一次性配置
composer install
-./vendor/bin/dload init # 仅第一次
+./vendor/bin/dload init # 仅第一次需要
./vendor/bin/dload get
```
-### 新项目设置
+### 新项目创建
```bash
-# 使用 DLoad 启动新项目
+# 使用 DLoad 开始新项目
composer init
composer require internal/dload -W
./vendor/bin/dload init
@@ -352,14 +508,14 @@ composer require internal/dload -W
run: GITHUB_TOKEN=${{ secrets.GITHUB_TOKEN }} ./vendor/bin/dload get
```
-### 跨平台团队
+### 跨平台团队协作
-每个开发者获得适合其系统的正确二进制文件：
+每个开发者都能获得适合其系统的正确二进制文件：
```xml
-
-
+
+
```
@@ -371,12 +527,12 @@ composer require internal/dload -W
-
+
```
-### 前端资产分发
+### 前端资源分发
```xml
@@ -391,18 +547,18 @@ composer require internal/dload -W
## GitHub API 速率限制
-使用个人访问令牌以避免速率限制：
+使用个人访问令牌来避免速率限制：
```bash
GITHUB_TOKEN=your_token_here ./vendor/bin/dload get
```
-将其添加到 CI/CD 环境变量中以进行自动下载。
+在 CI/CD 环境变量中添加此配置，以便自动下载。
-## 贡献
+## 参与贡献
-欢迎贡献！提交拉取请求以：
+欢迎贡献！你可以提交拉取请求来：
- 向预定义注册表添加新软件
-- 改进 DLoad 功能
+- 改进 DLoad 功能
- 增强文档并将其翻译为[其他语言](docs/guidelines/how-to-translate-readme-docs.md)
diff --git a/README.md b/README.md
index 6a428c0..f3ae368 100644
--- a/README.md
+++ b/README.md
@@ -32,6 +32,43 @@ With DLoad, you can:
- Manage cross-platform compatibility without manual configuration
- Keep binaries and assets separate from your version control
+### Table of Contents
+
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Command Line Usage](#command-line-usage)
+ - [Initialize Configuration](#initialize-configuration)
+ - [Download Software](#download-software)
+ - [View Software](#view-software)
+ - [Build Custom Software](#build-custom-software)
+- [Configuration Guide](#configuration-guide)
+ - [Interactive Configuration](#interactive-configuration)
+ - [Manual Configuration](#manual-configuration)
+ - [Download Types](#download-types)
+ - [Version Constraints](#version-constraints)
+ - [Advanced Configuration Options](#advanced-configuration-options)
+- [Building Custom RoadRunner](#building-custom-roadrunner)
+ - [Build Action Configuration](#build-action-configuration)
+ - [Velox Action Attributes](#velox-action-attributes)
+ - [Build Process](#build-process)
+ - [Configuration File Generation](#configuration-file-generation)
+ - [Using Downloaded Velox](#using-downloaded-velox)
+ - [DLoad Configuration](#dload-configuration)
+ - [Building RoadRunner](#building-roadrunner)
+- [Custom Software Registry](#custom-software-registry)
+ - [Defining Software](#defining-software)
+ - [Software Elements](#software-elements)
+- [Use Cases](#use-cases)
+ - [Development Environment Setup](#development-environment-setup)
+ - [New Project Setup](#new-project-setup)
+ - [CI/CD Integration](#cicd-integration)
+ - [Cross-Platform Teams](#cross-platform-teams)
+ - [PHAR Tools Management](#phar-tools-management)
+ - [Frontend Asset Distribution](#frontend-asset-distribution)
+- [GitHub API Rate Limits](#github-api-rate-limits)
+- [Contributing](#contributing)
+
+
## Installation
```bash
@@ -147,6 +184,25 @@ Alternatively, you can download the latest release from [GitHub releases](https:
./vendor/bin/dload show --all
```
+### Build Custom Software
+
+```bash
+# Build custom software using configuration file
+./vendor/bin/dload build
+
+# Build with specific configuration file
+./vendor/bin/dload build --config=./custom-dload.xml
+```
+
+#### Build Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--config` | Path to configuration file | ./dload.xml |
+
+The `build` command executes build actions defined in your configuration file, such as creating custom RoadRunner binaries with specific plugins.
+For detailed information about building custom RoadRunner, see the [Building Custom RoadRunner](#building-custom-roadrunner) section.
+
## Configuration Guide
### Interactive Configuration
@@ -267,6 +323,107 @@ Use Composer-style version constraints:
```
+## Building Custom RoadRunner
+
+DLoad supports building custom RoadRunner binaries using the Velox build tool. This is useful when you need RoadRunner with custom plugin combinations that aren't available in pre-built releases.
+
+### Build Action Configuration
+
+```xml
+
+
+
+
+
+
+
+
+
+
+
+
+
+```
+
+### Velox Action Attributes
+
+| Attribute | Description |
+|-----------|-------------|
+| `velox-version` | Version constraint for the Velox build tool to use |
+| `golang-version` | Go version constraint required for building RoadRunner |
+| `roadrunner-ref` | RoadRunner Git reference (tag, commit, or branch) to use as the base for building |
+| `config-file` | Path to base configuration file that may be merged with remote API responses or other sources |
+| `binary-path` | Output path for the built RoadRunner binary. File extension is automatically added based on OS (`.exe` for Windows). Defaults to current working directory |
+| `debug` | Build RoadRunner with debug symbols to profile it with pprof (boolean, defaults to `false`) |
+
+### Build Process
+
+DLoad automatically handles the build process:
+
+1. **Golang Check**: Verifies Go is installed globally (required dependency)
+2. **Velox Preparation**: Uses Velox from global installation, local download, or downloads automatically if needed
+3. **Configuration**: Copies your local velox.toml to build directory
+4. **Building**: Executes `vx build` command with specified configuration
+5. **Installation**: Moves built binary to target location and sets executable permissions
+6. **Cleanup**: Removes temporary build files
+
+> [!NOTE]
+> DLoad requires Go (Golang) to be installed globally on your system. It does not download or manage Go installations.
+
+### Configuration File Generation
+
+You can generate a `velox.toml` configuration file using the online builder at https://build.roadrunner.dev/
+
+For detailed documentation on Velox configuration options and examples, visit https://docs.roadrunner.dev/docs/customization/build
+
+This web interface helps you select plugins and generates the appropriate configuration for your custom RoadRunner build.
+
+### Using Downloaded Velox
+
+You can download Velox as part of your build process instead of relying on a globally installed version:
+
+```xml
+
+
+
+
+```
+
+This ensures consistent Velox versions across different environments and team members.
+
+### DLoad Configuration
+
+```xml
+
+
+
+
+
+
+```
+
+### Building RoadRunner
+
+```bash
+# Build RoadRunner using velox.toml configuration
+./vendor/bin/dload build
+
+# Build with specific configuration file
+./vendor/bin/dload build --config=custom-rr.xml
+```
+
## Custom Software Registry
### Defining Software
diff --git a/bin/dload b/bin/dload
index 419f400..9eca91d 100644
--- a/bin/dload
+++ b/bin/dload
@@ -50,6 +50,7 @@ use Symfony\Component\Console\CommandLoader\FactoryCommandLoader;
Command\ListSoftware::getDefaultName() => static fn() => new Command\ListSoftware(),
Command\Show::getDefaultName() => static fn() => new Command\Show(),
Command\Init::getDefaultName() => static fn() => new Command\Init(),
+ Command\Build::getDefaultName() => static fn() => new Command\Build(),
]),
);
$application->setDefaultCommand(Command\Get::getDefaultName(), false);
diff --git a/composer.lock b/composer.lock
index 347c577..1154bbd 100644
--- a/composer.lock
+++ b/composer.lock
@@ -650,16 +650,16 @@
},
{
"name": "symfony/console",
- "version": "v6.4.22",
+ "version": "v6.4.23",
"source": {
"type": "git",
"url": "https://github.com/symfony/console.git",
- "reference": "7d29659bc3c9d8e9a34e2c3414ef9e9e003e6cf3"
+ "reference": "9056771b8eca08d026cd3280deeec3cfd99c4d93"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/symfony/console/zipball/7d29659bc3c9d8e9a34e2c3414ef9e9e003e6cf3",
- "reference": "7d29659bc3c9d8e9a34e2c3414ef9e9e003e6cf3",
+ "url": "https://api.github.com/repos/symfony/console/zipball/9056771b8eca08d026cd3280deeec3cfd99c4d93",
+ "reference": "9056771b8eca08d026cd3280deeec3cfd99c4d93",
"shasum": ""
},
"require": {
@@ -724,7 +724,7 @@
"terminal"
],
"support": {
- "source": "https://github.com/symfony/console/tree/v6.4.22"
+ "source": "https://github.com/symfony/console/tree/v6.4.23"
},
"funding": [
{
@@ -740,7 +740,7 @@
"type": "tidelift"
}
],
- "time": "2025-05-07T07:05:04+00:00"
+ "time": "2025-06-27T19:37:22+00:00"
},
{
"name": "symfony/deprecation-contracts",
@@ -811,16 +811,16 @@
},
{
"name": "symfony/http-client",
- "version": "v6.4.19",
+ "version": "v6.4.23",
"source": {
"type": "git",
"url": "https://github.com/symfony/http-client.git",
- "reference": "3294a433fc9d12ae58128174896b5b1822c28dad"
+ "reference": "19f11e742b94dcfd968a54f5381bb9082a88cb57"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/symfony/http-client/zipball/3294a433fc9d12ae58128174896b5b1822c28dad",
- "reference": "3294a433fc9d12ae58128174896b5b1822c28dad",
+ "url": "https://api.github.com/repos/symfony/http-client/zipball/19f11e742b94dcfd968a54f5381bb9082a88cb57",
+ "reference": "19f11e742b94dcfd968a54f5381bb9082a88cb57",
"shasum": ""
},
"require": {
@@ -884,7 +884,7 @@
"http"
],
"support": {
- "source": "https://github.com/symfony/http-client/tree/v6.4.19"
+ "source": "https://github.com/symfony/http-client/tree/v6.4.23"
},
"funding": [
{
@@ -900,7 +900,7 @@
"type": "tidelift"
}
],
- "time": "2025-02-13T09:55:13+00:00"
+ "time": "2025-06-27T20:02:31+00:00"
},
{
"name": "symfony/http-client-contracts",
@@ -3121,58 +3121,59 @@
},
{
"name": "friendsofphp/php-cs-fixer",
- "version": "v3.75.0",
+ "version": "v3.82.2",
"source": {
"type": "git",
"url": "https://github.com/PHP-CS-Fixer/PHP-CS-Fixer.git",
- "reference": "399a128ff2fdaf4281e4e79b755693286cdf325c"
+ "reference": "684ed3ab41008a2a4848de8bde17eb168c596247"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/PHP-CS-Fixer/PHP-CS-Fixer/zipball/399a128ff2fdaf4281e4e79b755693286cdf325c",
- "reference": "399a128ff2fdaf4281e4e79b755693286cdf325c",
+ "url": "https://api.github.com/repos/PHP-CS-Fixer/PHP-CS-Fixer/zipball/684ed3ab41008a2a4848de8bde17eb168c596247",
+ "reference": "684ed3ab41008a2a4848de8bde17eb168c596247",
"shasum": ""
},
"require": {
"clue/ndjson-react": "^1.0",
"composer/semver": "^3.4",
- "composer/xdebug-handler": "^3.0.3",
+ "composer/xdebug-handler": "^3.0.5",
"ext-filter": "*",
"ext-hash": "*",
"ext-json": "*",
"ext-tokenizer": "*",
"fidry/cpu-core-counter": "^1.2",
"php": "^7.4 || ^8.0",
- "react/child-process": "^0.6.5",
+ "react/child-process": "^0.6.6",
"react/event-loop": "^1.0",
- "react/promise": "^2.0 || ^3.0",
+ "react/promise": "^2.11 || ^3.0",
"react/socket": "^1.0",
"react/stream": "^1.0",
- "sebastian/diff": "^4.0 || ^5.1 || ^6.0 || ^7.0",
- "symfony/console": "^5.4 || ^6.4 || ^7.0",
- "symfony/event-dispatcher": "^5.4 || ^6.4 || ^7.0",
- "symfony/filesystem": "^5.4 || ^6.4 || ^7.0",
- "symfony/finder": "^5.4 || ^6.4 || ^7.0",
- "symfony/options-resolver": "^5.4 || ^6.4 || ^7.0",
- "symfony/polyfill-mbstring": "^1.31",
- "symfony/polyfill-php80": "^1.31",
- "symfony/polyfill-php81": "^1.31",
- "symfony/process": "^5.4 || ^6.4 || ^7.2",
- "symfony/stopwatch": "^5.4 || ^6.4 || ^7.0"
+ "sebastian/diff": "^4.0.6 || ^5.1.1 || ^6.0.2 || ^7.0",
+ "symfony/console": "^5.4.45 || ^6.4.13 || ^7.0",
+ "symfony/event-dispatcher": "^5.4.45 || ^6.4.13 || ^7.0",
+ "symfony/filesystem": "^5.4.45 || ^6.4.13 || ^7.0",
+ "symfony/finder": "^5.4.45 || ^6.4.17 || ^7.0",
+ "symfony/options-resolver": "^5.4.45 || ^6.4.16 || ^7.0",
+ "symfony/polyfill-mbstring": "^1.32",
+ "symfony/polyfill-php80": "^1.32",
+ "symfony/polyfill-php81": "^1.32",
+ "symfony/process": "^5.4.47 || ^6.4.20 || ^7.2",
+ "symfony/stopwatch": "^5.4.45 || ^6.4.19 || ^7.0"
},
"require-dev": {
"facile-it/paraunit": "^1.3.1 || ^2.6",
"infection/infection": "^0.29.14",
- "justinrainbow/json-schema": "^5.3 || ^6.2",
- "keradus/cli-executor": "^2.1",
+ "justinrainbow/json-schema": "^5.3 || ^6.4",
+ "keradus/cli-executor": "^2.2",
"mikey179/vfsstream": "^1.6.12",
- "php-coveralls/php-coveralls": "^2.7",
+ "php-coveralls/php-coveralls": "^2.8",
"php-cs-fixer/accessible-object": "^1.1",
"php-cs-fixer/phpunit-constraint-isidenticalstring": "^1.6",
"php-cs-fixer/phpunit-constraint-xmlmatchesxsd": "^1.6",
- "phpunit/phpunit": "^9.6.22 || ^10.5.45 || ^11.5.12",
- "symfony/var-dumper": "^5.4.48 || ^6.4.18 || ^7.2.3",
- "symfony/yaml": "^5.4.45 || ^6.4.18 || ^7.2.3"
+ "phpunit/phpunit": "^9.6.23 || ^10.5.47 || ^11.5.25",
+ "symfony/polyfill-php84": "^1.32",
+ "symfony/var-dumper": "^5.4.48 || ^6.4.23 || ^7.3.1",
+ "symfony/yaml": "^5.4.45 || ^6.4.23 || ^7.3.1"
},
"suggest": {
"ext-dom": "For handling output formats in XML",
@@ -3213,7 +3214,7 @@
],
"support": {
"issues": "https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues",
- "source": "https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/tree/v3.75.0"
+ "source": "https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/tree/v3.82.2"
},
"funding": [
{
@@ -3221,7 +3222,7 @@
"type": "github"
}
],
- "time": "2025-03-31T18:40:42+00:00"
+ "time": "2025-07-08T21:13:15+00:00"
},
{
"name": "kelunik/certificate",
@@ -3457,16 +3458,16 @@
},
{
"name": "myclabs/deep-copy",
- "version": "1.13.1",
+ "version": "1.13.3",
"source": {
"type": "git",
"url": "https://github.com/myclabs/DeepCopy.git",
- "reference": "1720ddd719e16cf0db4eb1c6eca108031636d46c"
+ "reference": "faed855a7b5f4d4637717c2b3863e277116beb36"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/myclabs/DeepCopy/zipball/1720ddd719e16cf0db4eb1c6eca108031636d46c",
- "reference": "1720ddd719e16cf0db4eb1c6eca108031636d46c",
+ "url": "https://api.github.com/repos/myclabs/DeepCopy/zipball/faed855a7b5f4d4637717c2b3863e277116beb36",
+ "reference": "faed855a7b5f4d4637717c2b3863e277116beb36",
"shasum": ""
},
"require": {
@@ -3505,7 +3506,7 @@
],
"support": {
"issues": "https://github.com/myclabs/DeepCopy/issues",
- "source": "https://github.com/myclabs/DeepCopy/tree/1.13.1"
+ "source": "https://github.com/myclabs/DeepCopy/tree/1.13.3"
},
"funding": [
{
@@ -3513,7 +3514,7 @@
"type": "tidelift"
}
],
- "time": "2025-04-29T12:36:36+00:00"
+ "time": "2025-07-05T12:25:42+00:00"
},
{
"name": "netresearch/jsonmapper",
@@ -4441,16 +4442,16 @@
},
{
"name": "phpunit/phpunit",
- "version": "10.5.47",
+ "version": "10.5.48",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/phpunit.git",
- "reference": "3637b3e50d32ab3a0d1a33b3b6177169ec3d95a3"
+ "reference": "6e0a2bc39f6fae7617989d690d76c48e6d2eb541"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/sebastianbergmann/phpunit/zipball/3637b3e50d32ab3a0d1a33b3b6177169ec3d95a3",
- "reference": "3637b3e50d32ab3a0d1a33b3b6177169ec3d95a3",
+ "url": "https://api.github.com/repos/sebastianbergmann/phpunit/zipball/6e0a2bc39f6fae7617989d690d76c48e6d2eb541",
+ "reference": "6e0a2bc39f6fae7617989d690d76c48e6d2eb541",
"shasum": ""
},
"require": {
@@ -4460,7 +4461,7 @@
"ext-mbstring": "*",
"ext-xml": "*",
"ext-xmlwriter": "*",
- "myclabs/deep-copy": "^1.13.1",
+ "myclabs/deep-copy": "^1.13.3",
"phar-io/manifest": "^2.0.4",
"phar-io/version": "^3.2.1",
"php": ">=8.1",
@@ -4522,7 +4523,7 @@
"support": {
"issues": "https://github.com/sebastianbergmann/phpunit/issues",
"security": "https://github.com/sebastianbergmann/phpunit/security/policy",
- "source": "https://github.com/sebastianbergmann/phpunit/tree/10.5.47"
+ "source": "https://github.com/sebastianbergmann/phpunit/tree/10.5.48"
},
"funding": [
{
@@ -4546,7 +4547,7 @@
"type": "tidelift"
}
],
- "time": "2025-06-20T11:29:11+00:00"
+ "time": "2025-07-11T04:07:17+00:00"
},
{
"name": "psr/event-dispatcher",
@@ -6801,16 +6802,16 @@
},
{
"name": "symfony/var-dumper",
- "version": "v6.4.21",
+ "version": "v6.4.23",
"source": {
"type": "git",
"url": "https://github.com/symfony/var-dumper.git",
- "reference": "22560f80c0c5cd58cc0bcaf73455ffd81eb380d5"
+ "reference": "d55b1834cdbfcc31bc2cd7e095ba5ed9a88f6600"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/symfony/var-dumper/zipball/22560f80c0c5cd58cc0bcaf73455ffd81eb380d5",
- "reference": "22560f80c0c5cd58cc0bcaf73455ffd81eb380d5",
+ "url": "https://api.github.com/repos/symfony/var-dumper/zipball/d55b1834cdbfcc31bc2cd7e095ba5ed9a88f6600",
+ "reference": "d55b1834cdbfcc31bc2cd7e095ba5ed9a88f6600",
"shasum": ""
},
"require": {
@@ -6866,7 +6867,7 @@
"dump"
],
"support": {
- "source": "https://github.com/symfony/var-dumper/tree/v6.4.21"
+ "source": "https://github.com/symfony/var-dumper/tree/v6.4.23"
},
"funding": [
{
@@ -6882,7 +6883,7 @@
"type": "tidelift"
}
],
- "time": "2025-04-09T07:34:50+00:00"
+ "time": "2025-06-27T15:05:27+00:00"
},
{
"name": "ta-tikoma/phpunit-architecture-test",
@@ -6995,16 +6996,16 @@
},
{
"name": "vimeo/psalm",
- "version": "6.12.0",
+ "version": "6.12.1",
"source": {
"type": "git",
"url": "https://github.com/vimeo/psalm.git",
- "reference": "cf420941d061a57050b6c468ef2c778faf40aee2"
+ "reference": "e71404b0465be25cf7f8a631b298c01c5ddd864f"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/vimeo/psalm/zipball/cf420941d061a57050b6c468ef2c778faf40aee2",
- "reference": "cf420941d061a57050b6c468ef2c778faf40aee2",
+ "url": "https://api.github.com/repos/vimeo/psalm/zipball/e71404b0465be25cf7f8a631b298c01c5ddd864f",
+ "reference": "e71404b0465be25cf7f8a631b298c01c5ddd864f",
"shasum": ""
},
"require": {
@@ -7109,7 +7110,7 @@
"issues": "https://github.com/vimeo/psalm/issues",
"source": "https://github.com/vimeo/psalm"
},
- "time": "2025-05-28T12:52:06+00:00"
+ "time": "2025-07-04T09:56:28+00:00"
},
{
"name": "webmozart/assert",
diff --git a/dload.xsd b/dload.xsd
index 5a69122..a73eac3 100644
--- a/dload.xsd
+++ b/dload.xsd
@@ -58,11 +58,78 @@
+
+
+
+ Velox build action for creating custom RoadRunner binaries
+
+
+
+
+
+ Plugin to include in the RoadRunner build
+
+
+
+
+ Plugin name (required)
+
+
+
+
+ Plugin version constraint
+
+
+
+
+ Repository owner/organization
+
+
+
+
+ Repository name
+
+
+
+
+
+
+
+ Version constraint for velox build tool
+
+
+
+
+ Required Go version constraint
+
+
+
+
+ RoadRunner Git reference (tag, commit, or branch) to use for building
+
+
+
+
+ Path to local velox.toml file
+
+
+
+
+ Path to the RoadRunner binary to build
+
+
+
+
+ Build RoadRunner with debug symbols to profile it with pprof
+
+
+
+
@@ -185,4 +252,4 @@
-
\ No newline at end of file
+
diff --git a/docs/guidelines/how-to-translate-readme-docs.md b/docs/guidelines/how-to-translate-readme-docs.md
index 5d4de57..d92874a 100644
--- a/docs/guidelines/how-to-translate-readme-docs.md
+++ b/docs/guidelines/how-to-translate-readme-docs.md
@@ -28,6 +28,7 @@ I need a single message with all the md file content.
- Command examples and their arguments: Verify technical accuracy and formatting.
- Technical terminology consistency throughout the document.
- Cultural adaptations that make sense in target language context.
+ - **Language naturalness**: Ensure the translation uses natural, living language that doesn't sound synthetic or machine-generated, while maintaining technical precision. Find the golden mean between conversational flow and technical accuracy.
**Step 5: Finalize and Save the Translated Document 💾**
@@ -91,6 +92,7 @@ CONTRIBUTING-de.md
- Use clear and specific prompts to minimize errors.
- Always double-check technical content, as LLMs may mistranslate code or markup.
+- **Prioritize natural language flow**: Avoid overly literal translations that sound robotic. The text should read as if written by a native speaker while preserving technical accuracy.
- Consider using frameworks like MAPS (Multi-Aspect Prompting and Selection) for complex translations, which guide the LLM through keywords, topics, and relevant examples to improve accuracy and reduce errors.
- Remember: Human review is essential for catching subtle mistakes and ensuring the translation meets your quality standards.
diff --git a/psalm-baseline.xml b/psalm-baseline.xml
index 05d441f..0f1aded 100644
--- a/psalm-baseline.xml
+++ b/psalm-baseline.xml
@@ -1,5 +1,5 @@
-
+
binary]]>
+
@@ -125,15 +127,28 @@
-
+
]]>
+
-
-
- factory]]>
@@ -162,6 +183,9 @@
cache]]>
+
+ injector->invoke([$binding, 'create'])]]>
+
getRepository()->getName(),
- $this->getVersion(),
- ]]]>
-
assets as $assetDTO) {
@@ -393,18 +383,49 @@
isSatisfiedBy($this->version)]]>
+
+
+