Хроники Yii3
618 subscribers
43 photos
1.68K links
Описание процесса разработки фреймворка из первых рук 😎

Обсуждение:
https://t.me/yii3ru

Сводка по всем пакетам:
https://www.yiiframework.com/status/3.0

Поддержать разработчиков:
https://opencollective.com/yiisoft
Download Telegram
#yiisoftValidator #МажорныйРелиз #Релиз

🎁 Yii Validator 2.0

• Добавлено правило InEnum, проверяющее, что значение соответствует одному из значений типизированного перечисления.

• В именах классов/трейтов/методов/переменных слово "attribute" заменено на "property".

• Переименованы правила:
- AtLeastFilledAtLeast;
- OneOfFilledOnlyOneOf.

• При создании правила FilledAtLeast добавлена проверка, что значение свойства $min меньше или равно количеству проверяемых свойств.

• Добавлен PHP-атрибут Label позволяющий задать имя свойства в сообщениях об ошибках валидации.

• Интерфейс RuleWithOptionsInterface переименован в DumpedRuleInterface.

• Метод getName() перемещён из метода RuleInterface в DumpedRuleInterface.

• Параметр $rules в методе RulesNormalizer::normalize() сделан опциональным.

• Выполнен рефакторинг метода Result::add(): для повышения производительности использование метода array_merge() вынесено за цикл foreach.

• Выполнен рефакторинг обработчика правила Json. Для проверки вместо регулярного выражения теперь используются встроенные функции json_validate(), json_decode() и json_last_error().

• Изменён тип параметра $escape в методе Error::getValuePath() с bool|string|null на string|null.

• Изменён тип параметра $skipOnEmpty в конструкуторах правил с mixed на bool|callable|null.

• Изменён тип параметра $rule в методе RuleHandlerInterface::validate() с object на RuleInterface.

• Для правил, не реализающих DumpedRuleInterface, RulesDumper теперь использует в качестве имени полное имя класса правила.

• Встроенные правила валидации в качестви имени правила теперь возвращают полное имя класса.

• В контекст валидации добавлен параметр Each::PARAMETER_EACH_KEY, доступный во время обработки правила Each и содержащий текущий ключ.

• В сообщения об ошибках валидации добавлены имена валидируемых свойств.

• Во встроенных правила в сообщения о некорректном типе валидируемого значения добавлен тип значения.

• Улучшены сообщения об ошибках валидации в правилах Json, FilledOnlyOneOf и FilledAtLeast.

• Исправлено: правила валидации, заданные в виде PHP-атрибутов объекта, не учитывались при нормализации через RulesNormalizer::normalize().

• Исправлено: при использовании правила Nested имя свойства не передавалось в сообщения об ошибках валидации.

• Исправлено: при использовании правила Each в сообщение о некорректном ключе передавался тип значения вместо типа ключа.

• Уточнены типы в psalm-аннотациях в классе Result.

• Минимальная требуемая версия PHP поднята до 8.1.

• Добавлен перевод сообщений об ошибках валидации на немецкий язык.

Инструкция по обновлению на эту мажорную версию описана в файле UPGRADE.md.
#yiisoftNetworkUtilities #МинорныйРелиз #Релиз

🎁 Yii Network Utilities 1.1

• Добавлен объект IpRanges, который содержит диапазоны IP-адресов и позволяет проверить входит ли конкретный IP-адрес в эти диапазоны.

• Исправлена ошибка при преобразовании IP-адреса в битовое представление в PHP 8.0+.
#yiisoftProxyMiddleware #ПатчРелиз #Релиз

🎁 Yii Proxy Middleware 1.0.2

• Зависимость от yiisoft/validator заменена на более простую yiisoft/network-utilities.
#yiisoftHydratorValidator #ПатчРелиз #Релиз

🎁 Yii Validating Hydrator 2.0.1

• Добавлена поддержка yiisoft/validator версии ^2.0.
#yiisoftInputHttp #ПатчРелиз #Релиз

🎁 Yii Input HTTP 1.0.1

• Добавлена поддержка yiisoft/validator версии ^2.0.
#yiisoftHydrator #МинорныйРелиз #Релиз

🎁 Yii Hydrator 1.3

• Добавлена поддержка гидрирования неинициализированных readonly свойств.

• Добавлена поддержка коллекций через атрибут Collection.

• Гидратор добавлен в качестве зависимости в ParameterAttributesHandler (можно установить через новый метод withHydrator()) и ParameterAttributeResolveContext (можно получить через новый метод getHydrator()).
#yiisoftAuthJwt #МинорныйРелиз #Релиз

🎁 Yii Auth JWT 2.1

• В зависимостях пакеты web-token/* заменены на один web-token/jwt-library, минимальная версия PHP поднята до 8.1.

• Добавлена поддержка psr/http-message для версий ^2.0.
#yiisoftHtml #МинорныйРелиз #Релиз

🎁 Yii HTML 3.6

• Добавлена поддержка перечислений (enum) в качестве значения в виджетах CheckboxList и RadioList.

• Добавлена поддержка Stringable-объектов и массивов в качестве значения для тега <textarea>.

• Добавлено исключение, возникающее при передаче некорректных имён HTML-атрибутов (пустое имя или содержащее запрещённые символы).

• Исправлено: теперь вложенные атрибуты (data и другие) не выводятся, если содержат значение null.
#yiisoftHydrator #МинорныйРелиз #Релиз

🎁 Yii Hydrator 1.4

• Добавлен PHP-атрибут ToArrayOfString, позволяющий привести значение к массиву строк.

• В коллекциях добавлена поддержка типизированных перечислений.
#yiisoftForm #ПервыйРелиз #МажорныйРелиз #Релиз

🎁 Yii Form 1.0

Пакет содержит набор виджетов для генерации HTML-кода полей форм с поддержкой тем (из коробки поддерживается Bootstrap 5).

Пример использования:

use Yiisoft\Form\PureField\Field;

echo Field::text('firstName', theme: 'horizontal')
->label('First Name')
->autofocus();
echo Field::text('lastName', theme: 'horizontal')
->label('Last Name');
echo Field::select('sex')
->label('Sex')
->optionsData(['m' => 'Male', 'f' => 'Female'])
->prompt('—');
echo Field::number('age')
->label('Age')
->hint('Please enter your age.');
echo Field::submitButton('Submit')
->buttonClass('primary');
#yiisoftFormModel #ПервыйРелиз #МажорныйРелиз #Релиз

🎁 Yii Form Model 1.0

Пакет предоставляет основу для реализации моделей форм и помогает в их наполнении, валидации и отображении.

Пример формы:

use Yiisoft\FormModel\Attribute\Safe;
use Yiisoft\FormModel\FormModel;
use Yiisoft\Validator\Rule\Email;
use Yiisoft\Validator\Rule\Length;
use Yiisoft\Validator\Rule\Required;

final class LoginForm extends FormModel
{
#[Label('Your login')]
#[Required]
#[Length(min: 4, max: 40, skipOnEmpty: true)]
#[Email(skipOnEmpty: true)]
private ?string $login = null;

#[Label('Your password')]
#[Required]
#[Length(min: 8, skipOnEmpty: true)]
private ?string $password = null;

#[Label('Remember me for 1 week')]
#[Safe]
private bool $rememberMe = false;
}


Пример обработки формы:

public function login(
RequestInterface $request,
FormHydrator $formHydrator
): ResponseInterface
{
$formModel = new LoginForm();
if ($formHydrator->populateFromPostAndValidate($formModel, $request)) {
$errors = $formModel->getValidationResult()->getErrorMessagesIndexedByProperty();
}
// You can pass $formModel and $errors to the view now.
}


Пример отображения формы:

use Yiisoft\FormModel\Field;
use Yiisoft\FormModel\FormModel;

echo Field::text($formModel, 'login');
echo Field::password($formModel, 'password');
echo Field::checkbox($formModel, 'rememberMe');
#yiisoftNetworkUtilities #МинорныйРелиз #Релиз

🎁 Yii Network Utilities 1.2

• В IpHelper добавлены константы IP_PATTERN и IP_REGEXP для проверки IP обеих версий (IPv4 и IPv6).

• В IpRanges добавлена константа NEGATION_CHARACTER, используемая для определения диапазонов методом исключения.

• В IpHelper добавили методы: isIpv4(), isIpv6(), isIp().
#yiisoftMiddleware #ПатчРелиз #Релиз

🎁 Yii Middleware 1.0.4

• Добавлен пакет yiisoft/network-utilities в качестве зависимости и использован вместо пакета yiisoft/validator для фильтра IpFilter.

• Добавлена поддержка для yiisoft/validator версий ^2.0, зависимость помечена как deprecated.
#yiisoftSwagger #МинорныйРелиз #Релиз

🎁 Yii Swagger 2.1

• Добавлена поддержкаpsr/http-message для версий ^2.0.

• Требуемая версия yiisoft/yii-view обновлена до ^7.1.

• Добавлены экшены \Yiisoft\Swagger\Action\SwaggerJson и \Yiisoft\Swagger\Action\SwaggerUi. Классы \Yiisoft\Swagger\Middleware\SwaggerJson и \Yiisoft\Swagger\Middleware\SwaggerUi помечены как deprecated. Они будут удалены в следующей мажорной версии.

• Добавлена поддержка swagger-api/swagger-ui 5й версии.
#yiisoftSwagger #ПатчРелиз #Релиз

🎁 Yii Swagger 2.1.1

• Зависимость yiisoft/yii-view заменена на yiisoft/yii-view-renderer.
#yiisoftValidator #МинорныйРелиз #Релиз

🎁 Yii Validator 2.1

• Правила валидации объекта, описанные в виде PHP атрибутов теперь объединяются с правилами, заданными в методе getRules() при реализации интерфейса RulesProviderInterface.

• Выполнен рефакторинг правила Ip с более плотным использованием пакета yiisoft/network-utilities.

• Добавлен метод Ip::getIpRanges().

• Методы Ip::getRanges(), Ip::getNetworks() и Ip::isAllowed() помечены устаревшими и будут удалены в следующем мажорном релизе.
#yiisoftFormModel #ПатчРелиз #Релиз

🎁 Yii Form Model 1.0.1

• Пакет адаптирован к изменениям в последней версии валидатора. В модели формы разрешено наполнять только те поля, где есть правила валидации. Теперь правила валидации считываются одновременно и с PHP-атрибутов и из метода getRules().
🔥 #yiisoftActiveRecord #News

В пакете yiisoft/active-record методы класса, содержащие слово attribute, были переименованы.

- attributes() -> propertyNames()
- hasAttribute() -> hasProperty()
- getAttribute() -> get()
- getAttributes() -> propertyValues()
- getAttributesInternal() -> propertyValuesInternal()
- getOldAttribute() -> oldValue()
- getOldAttributes() -> oldValues()
- getDirtyAttributes() -> dirtyValues()
- markAttributeDirty() -> markPropertyDirty()
- isAttributeChanged() -> isPropertyChanged()
- setAttribute() -> set()
- setAttributes() -> populateProperties()
- populateAttribute() -> populateProperty()
- setOldAttribute() -> assignOldValue()
- setOldAttributes() -> assignOldValues()
- updateAttributes() -> updateProperties()

Переименование сделано, чтобы в будущем избежать путаницы с PHP атрибутами #[Attribute].
#yiisoftHydrator #МинорныйРелиз #Релиз

🎁 Yii Hydrator 1.5

• Добавлен тайпкастер EnumTypeCaster, позволяющий приводить значение к перечислению. Например, приведение строки draft к перечислению Status::DRAFT.

• Исправлена ошибка с заполнением свойств только для чтения из родительских классов.
#yiisoftHtml #МинорныйРелиз #Релиз

🎁 Yii HTML 3.7

• В теге Script добавлен методы nonce() и getNonce() для более удобной реализации CSP.

• В теге Select добавлена поддержка типизированных перечислений в качестве значения.