Как задать значение по умолчанию для поля сущности в Doctrine?

Проблема с options={"default"} в Doctrine

Вы абсолютно правы: опция options={"default": "active"} работает только на уровне генерации схемы базы данных. Она добавляет DEFAULT-значение в DDL-запрос при создании таблицы, но не влияет на PHP-объект. Когда вы создаете экземпляр сущности через new User(), свойство $status остается null, потому что вы его не инициализировали.

Правильное решение: инициализация в конструкторе

Самый надежный и рекомендуемый способ задать значение по умолчанию — инициализировать свойство прямо в конструкторе сущности. Это гарантирует, что при создании любого нового объекта поле будет иметь нужное значение на уровне PHP.

/**
 * @ORM\Entity(repositoryClass=UserRepository::class)
 */
class User
{
    /**
     * @ORM\Column(type="string", length=20)
     */
    private string $status;

    public function __construct()
    {
        $this->status = 'active';
    }

    // Геттер и сеттер
    public function getStatus(): string
    {
        return $this->status;
    }

    public function setStatus(string $status): self
    {
        $this->status = $status;
        return $this;
    }
}

Теперь при создании пользователя:

$user = new User();
echo $user->getStatus(); // 'active'
$em->persist($user);
$em->flush(); // сохранится со значением 'active'

Дополнительно: настройка на уровне БД

Если вы хотите, чтобы и база данных имела DEFAULT-значение (например, для прямых SQL-запросов или миграций), добавьте обе настройки:

/**
 * @ORM\Column(
 *     type="string",
 *     length=20,
 *     options={"default": "active"}
 * )
 */
private string $status = 'active'; // PHP-значение по умолчанию

Так вы получаете двойную защиту: PHP-уровень (конструктор или инициализация свойства) и SQL-уровень (DEFAULT в таблице).

Важные моменты

• Типизация: Используйте строгую типизацию (private string $status) — это поможет избежать случайных null-значений.
• Nullable-поля: Если поле может быть null, используйте ?string и не задавайте значение в конструкторе.
• Enum (PHP 8.1+): Для фиксированных статусов лучше использовать enum:

enum UserStatus: string
{
    case Active = 'active';
    case Inactive = 'inactive';
    case Banned = 'banned';
}

class User
{
    #[ORM\Column(type: 'string', enumType: UserStatus::class, options: ['default' => UserStatus::Active])]
    private UserStatus $status = UserStatus::Active;
}

Почему options={"default"} не работает в PHP?

Doctrine — это ORM, который работает в два этапа: PHP-объекты и SQL-схема. Опция default в аннотации/атрибуте влияет только на генерацию SQL (команда doctrine:schema:update или миграции). Она не меняет поведение PHP-класса. Поэтому всегда инициализируйте значения в конструкторе или прямо в объявлении свойства.

use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity]
#[ORM\HasLifecycleCallbacks]
class User
{
    #[ORM\Column(type: 'string', length: 20)]
    private ?string $status = null;

    #[ORM\PrePersist]
    public function setDefaultStatus(): void
    {
        if ($this->status === null) {
            $this->status = 'active';
        }
    }
}