docs: обновить README под lenient policy, английский — основной, русский — README.ru.md#2
Merged
Merged
Conversation
- описан мягкий (lenient) режим политик по умолчанию через LenientPolicy и Gate::before(), а также строгий режим (enforce_policies) - добавлен флаг enforce_policies и переменная FORMSTER_ENFORCE_POLICIES - добавлен README.en.md (полный перевод) и переключатель языка - исправлена сломанная ячейка таблицы AuraType (экранирование `|`)
- README.md теперь на английском (отображается на Packagist/GitHub) - русская версия перенесена в README.ru.md - поправлены ссылки переключателя языка
EgorGruzdev
changed the title
- пример быстрого старта: добавлен обязательный атрибут #[Aura] - явно указано, что мягкий режим политик требует #[Aura] на классе или его родителе; PHPDoc-модели без атрибута под него не попадают - расписано, какие проверки Gate где выполняются (строка/отправка/кнопка) - отмечено, что авто-enctype не срабатывает для list<File> - уточнено наследование action через @AWare (только файловые виджеты) - уточнён фолбэк описаний свойств и исключение PHP 8.2 × Laravel 13 в CI
- Color: регулярка валидации теперь /^#[0-9a-fA-F]{6}$/ (#4)
- enctype=multipart/form-data теперь автоматически ставится и для list<File> (#3)
- ActionHandler::update() пропускает read-only свойства (#5)
- Примечание: validate() зарезервирован, пакетом пока не вызывается (#5)
- Примечание: серверная обработка нескольких файлов (list<File>) ещё не реализована (#3)
Collaborator
|
Можно актуализировать обе версии документации (английскую и русскую) в соответствии с последними изменениями в пакете? |
- Новый раздел «Валидация»: сбор правил с обработчиков, validationRules у свойства, ellipsis-нотация '...', вывод ошибок, локализованные имена полей - Контракт PropertyHandler: validate() -> validationRules(), FinalAuraProperty - Таблица типов: колонка с правилами валидации по умолчанию - Сущности: FinalAura/FinalAuraProperty, finalize(), пополевное слияние AuraProperty::merge() при агрегации - Атрибуты: все параметры #[AuraProperty] опциональны, описание свойств через #[Aura(properties: [...])] - Дефолт property_parser: aura,phpstan,reflection - Стаб: переименован в formster-handler.stub, публикация --tag=formster-stub - Обновлён пример сгенерированного обработчика
Contributor
Author
|
Готово (b5852cf) — обе версии (README.md / README.ru.md) актуализированы под текущий master:
|
Collaborator
|
Можно актуализировать документацию ещё разок? |
Contributor
Author
|
Обновил (ca3f83c). С прошлого захода на master прилетело два коммита — 80ff3f5 и 37bb897, оба про ауру, под них и актуализировал обе версии:
По мелочи зацепил и смежные места: шаг «Парсинг» в разделе «Как это работает» и строку |
daniser
self-requested a review
July 10, 2026 12:16
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Что изменилось
После влития PR #1 на master появилась новая фича — lenient/enforce политики (теги
v1.4.0,v1.4.1). Логика fail-open переехала из хелпераgate_check()вGate::before()-колбэкLenientPolicyи стала конфигурируемой. Этот PR приводит документацию в соответствие, добавляет английскую версию и делает её основной.Раскладка файлов
README.md— теперь на английском (отображается на Packagist/GitHub по умолчанию).README.ru.md— русская версия.Актуализация под новую механику политик (обе версии)
LenientPolicy+Gate::before(), срабатывает только для объектов с#[Aura]) и строгий режим (enforce_policies/FORMSTER_ENFORCE_POLICIES).enforce_policies, в таблицу env —FORMSTER_ENFORCE_POLICIES.AuraType(неэкранированный|вA|Bрвал колонки) — теперьA\|B.Только документация — код не затрагивается.