diff --git a/lib/public/Install/Events/InstallationCompletedEvent.php b/lib/public/Install/Events/InstallationCompletedEvent.php new file mode 100644 index 00000000000..7cf75d76d6f --- /dev/null +++ b/lib/public/Install/Events/InstallationCompletedEvent.php @@ -0,0 +1,79 @@ +dataDirectory; + } + + /** + * Get the admin username if an admin user was created + * + * @since 33.0.0 + */ + public function getAdminUsername(): ?string { + return $this->adminUsername; + } + + /** + * Get the admin email if configured + * + * @since 33.0.0 + */ + public function getAdminEmail(): ?string { + return $this->adminEmail; + } + + /** + * Check if an admin user was created during installation + * + * @since 33.0.0 + */ + public function hasAdminUser(): bool { + return $this->adminUsername !== null; + } +} diff --git a/tests/lib/Install/Events/InstallationCompletedEventTest.php b/tests/lib/Install/Events/InstallationCompletedEventTest.php new file mode 100644 index 00000000000..3a973e008b9 --- /dev/null +++ b/tests/lib/Install/Events/InstallationCompletedEventTest.php @@ -0,0 +1,89 @@ +assertEquals($dataDir, $event->getDataDirectory()); + $this->assertEquals($adminUsername, $event->getAdminUsername()); + $this->assertEquals($adminEmail, $event->getAdminEmail()); + $this->assertTrue($event->hasAdminUser()); + } + + public function testConstructorWithMinimalParameters(): void { + $dataDir = '/path/to/data'; + + $event = new InstallationCompletedEvent($dataDir); + + $this->assertEquals($dataDir, $event->getDataDirectory()); + $this->assertNull($event->getAdminUsername()); + $this->assertNull($event->getAdminEmail()); + $this->assertFalse($event->hasAdminUser()); + } + + public function testConstructorWithUsernameOnly(): void { + $dataDir = '/path/to/data'; + $adminUsername = 'admin'; + + $event = new InstallationCompletedEvent($dataDir, $adminUsername); + + $this->assertEquals($dataDir, $event->getDataDirectory()); + $this->assertEquals($adminUsername, $event->getAdminUsername()); + $this->assertNull($event->getAdminEmail()); + $this->assertTrue($event->hasAdminUser()); + } + + public function testConstructorWithUsernameAndEmail(): void { + $dataDir = '/path/to/data'; + $adminUsername = 'admin'; + $adminEmail = 'admin@example.com'; + + $event = new InstallationCompletedEvent($dataDir, $adminUsername, $adminEmail); + + $this->assertEquals($dataDir, $event->getDataDirectory()); + $this->assertEquals($adminUsername, $event->getAdminUsername()); + $this->assertEquals($adminEmail, $event->getAdminEmail()); + $this->assertTrue($event->hasAdminUser()); + } + + public function testHasAdminUserReturnsFalseWhenUsernameIsNull(): void { + $event = new InstallationCompletedEvent('/path/to/data', null, 'admin@example.com'); + + $this->assertFalse($event->hasAdminUser()); + $this->assertNull($event->getAdminUsername()); + $this->assertEquals('admin@example.com', $event->getAdminEmail()); + } + + public function testDataDirectoryCanBeAnyString(): void { + $customPath = '/custom/data/directory'; + $event = new InstallationCompletedEvent($customPath); + + $this->assertEquals($customPath, $event->getDataDirectory()); + } + + public function testEmailCanBeSetWithoutUsername(): void { + $dataDir = '/path/to/data'; + $email = 'admin@example.com'; + + $event = new InstallationCompletedEvent($dataDir, null, $email); + + $this->assertNull($event->getAdminUsername()); + $this->assertEquals($email, $event->getAdminEmail()); + $this->assertFalse($event->hasAdminUser()); + } +}