20250807

help/class_desc/attributes/DefaultValue.md

@@ -0,0 +1,58 @@
+# Атрибут `DefaultValue`
+
+Атрибут `DefaultValue` предназначен для указания значения по умолчанию, которое будет использоваться для поля при
+отсутствии явно заданного значения. Он помогает поддерживать целостность данных и избегать неопределенности, возникающей
+при наличии необязательных полей.
+
+## Основное назначение
+
+Атрибут используется для явного указания значения, которое будет применяться к полю модели данных, если пользователь или
+программа не указали собственное значение. Это особенно полезно для тех случаев, когда данные нужны обязательно, но
+вводить их необязательно или сложно.
+
+## Пример использования атрибута
+
+Допустим, у вас есть модель данных, описывающая пользователя, и вы хотите назначить статус "активирован" по умолчанию
+каждому новому пользователю:
+
+```php
+use goodboyalex\php_db_components_pack\attributes\DefaultValue;
+
+final class User
+{
+    #[DefaultValue(true)]
+    private bool $Active;
+
+    // Остальные поля и геттеры/сеттеры...
+}
+```
+
+В данном примере атрибут `#[DefaultValue]` применяется к полю `$Active`, устанавливая значение по умолчанию равным
+`true`.
+
+## Пространство имён
+
+Атрибут объявлен в пространстве имён:
+
+```php
+namespace goodboyalex\php_db_components_pack\attributes;
+```
+
+## Версии и автор
+
+- **Автор**: Александр Бабаев
+- **Версия**: 1.0
+- **Дата выпуска**: с версии 1.0
+
+## Особенности
+
+- **Применяется только к полям (properties)**  
+  Атрибут используется исключительно для аннотирования полей классов, которые соответствуют столбцам базы данных.
+
+## Когда использовать атрибут?
+
+Атрибут `DefaultValue` отлично подходит для ситуаций, когда требуется автоматически заполнить поле некоторым значением,
+если оно не установлено явно. Например, можно назначать дефолтные роли пользователям, указывать исходные статусы заказов
+или временные отметки по умолчанию.
+
+[На главную](../../index.md)