2.9 KiB
Атрибут FieldName
Атрибут FieldName
предназначен для явного указания имени поля в базе данных, к которому привязано соответствующее
свойство модели. Он помогает устранить расхождения между именами свойств в коде и физическими именами столбцов в базе
данных.
Основное назначение
Атрибут используется для точной привязки полей модели данных к физическим столбцам базы данных. Это важно, когда имена свойств отличаются от имен столбцов, либо когда имеется желание переопределить схему именования полей.
Пример использования атрибута
Допустим, у вас есть модель данных, описывающая продукт, и вы хотите явно указать, что свойство $ProductCode
соответствует физическому полю prod_code
в базе данных:
use goodboyalex\php_db_components_pack\attributes\FieldName;
final class Product
{
#[FieldName('prod_code')]
private string $ProductCode;
// Остальные поля и геттеры/сеттеры...
}
В данном примере атрибут #[FieldName]
применяется к полю $ProductCode
, явно указывая, что оно связано с полем
prod_code
в базе данных.
Пространство имён
Атрибут объявлен в пространстве имён:
namespace goodboyalex\php_db_components_pack\attributes;
Версии и автор
- Автор: Александр Бабаев
- Версия: 1.0
- Дата выпуска: с версии 1.0
Особенности
- Применяется только к полям (properties)
Атрибут используется исключительно для аннотирования полей классов, которые соответствуют столбцам базы данных.
Когда использовать атрибут?
Атрибут FieldName
хорошо подходит для ситуаций, когда физическое имя столбца отличается от имени свойства в коде.
Например, это часто встречается в проектах, где физическая схема базы данных унаследована от сторонних источников или
была разработана ранее с иными соглашениями по именованию.