From 42a2c8efd95e78092586d5f0fd926153550bf3f6 Mon Sep 17 00:00:00 2001
From: lukinovec <lukinovec@gmail.com>
Date: Mon, 8 Jun 2026 10:03:07 +0200
Subject: [PATCH] Improve `$harden` annotation

---
 src/Bootstrappers/DatabaseTenancyBootstrapper.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/Bootstrappers/DatabaseTenancyBootstrapper.php b/src/Bootstrappers/DatabaseTenancyBootstrapper.php
index f27937d4..08ea5a74 100644
--- a/src/Bootstrappers/DatabaseTenancyBootstrapper.php
+++ b/src/Bootstrappers/DatabaseTenancyBootstrapper.php
@@ -20,6 +20,11 @@ class DatabaseTenancyBootstrapper implements TenancyBootstrapper
     /**
      * When true, throw an exception if a tenant gets connected to
      * another tenant's database or to the central database.
+     *
+     * If tenant's database name can be set during tenant creation by the users,
+     * the user creates a tenant that could connect to the database of another tenant.
+     * Setting $harden to true prevents this, but we keep it false by default since
+     * letting users specify the tenant database names is not that common.
      */
     public static bool $harden = false;