feat(setup-check): add ImagickSetupCheck

Adds ImagickSetupCheck to verify imagick PHP extension (optional).

Related issue: #6590
Type: Feature

Checklist:
- [x] Implement ISetupCheck interface
- [x] Check if imagick extension is loaded
- [x] Return info severity when not loaded (optional check)
- [x] Return success when loaded
- [x] Add unit tests covering both states

Author: guilhermercarvalho

lib/SetupCheck/ImagickSetupCheck.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * SPDX-FileCopyrightText: 2026 LibreCode coop and contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\Libresign\SetupCheck;
+
+use OCP\IL10N;
+use OCP\SetupCheck\ISetupCheck;
+use OCP\SetupCheck\SetupResult;
+
+class ImagickSetupCheck implements ISetupCheck {
+	private IL10N $l10n;
+
+	public function __construct(IL10N $l10n) {
+		$this->l10n = $l10n;
+	}
+
+	public function getName(): string {
+		return $this->l10n->t('Imagick PHP extension');
+	}
+
+	public function getCategory(): string {
+		return 'system';
+	}
+
+	public function run(): SetupResult {
+		if (!extension_loaded('imagick')) {
+			return SetupResult::info(
+				$this->l10n->t('Imagick extension is not loaded'),
+				$this->l10n->t('Install php-imagick to enable visible signatures, background images, and signature element rendering.')
+			);
+		}
+		return SetupResult::success($this->l10n->t('Imagick extension is loaded'));
+	}
+}

tests/php/Unit/SetupCheck/ImagickSetupCheckTest.php

@@ -0,0 +1,93 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * SPDX-FileCopyrightText: 2026 LibreCode coop and contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+/**
+ * Mock extension_loaded in the target namespace to control its behavior in tests.
+ */
+
+namespace OCA\Libresign\SetupCheck {
+  function extension_loaded(string $name): bool
+  {
+    return \OCA\Libresign\Tests\Unit\SetupCheck\ImagickSetupCheckTest::$mockExtensionLoaded[$name] ?? \extension_loaded($name);
+  }
+}
+
+namespace OCA\Libresign\Tests\Unit\SetupCheck {
+
+  use OCA\Libresign\SetupCheck\ImagickSetupCheck;
+  use OCP\IL10N;
+  use OCP\SetupCheck\SetupResult;
+  use PHPUnit\Framework\MockObject\MockObject;
+  use PHPUnit\Framework\TestCase;
+
+
+  class ImagickSetupCheckTest extends TestCase
+  {
+    /** @var array<string, bool> */
+    public static array $mockExtensionLoaded = [];
+
+    /** @var IL10N&MockObject */
+    private $l10n;
+
+    /** @var ImagickSetupCheck */
+    private $check;
+
+    protected function setUp(): void
+    {
+      parent::setUp();
+      self::$mockExtensionLoaded = [];
+
+      $this->l10n = $this->createMock(IL10N::class);
+      $this->l10n->method('t')
+        ->willReturnCallback(fn(string $text, array $parameters = []) => vsprintf($text, $parameters));
+
+      $this->check = new ImagickSetupCheck(
+        $this->l10n
+      );
+    }
+
+    public function testExtensionNotLoaded(): void
+    {
+      self::$mockExtensionLoaded['imagick'] = false;
+      $check = new ImagickSetupCheck($this->l10n);
+
+      $result = $check->run();
+
+      $this->assertInstanceOf(SetupResult::class, $result);
+      $this->assertEquals('info', $result->getSeverity());
+      $this->assertStringContainsString('Imagick extension is not loaded', $result->getDescription());
+      $this->assertNotNull($result->getDescription());
+    }
+
+    public function testExtensionLoaded(): void
+    {
+      self::$mockExtensionLoaded['imagick'] = true;
+      $check = new ImagickSetupCheck($this->l10n);
+
+      $result = $check->run();
+
+      $this->assertInstanceOf(SetupResult::class, $result);
+      $this->assertEquals('success', $result->getSeverity());
+      $this->assertStringContainsString('Imagick extension is loaded', $result->getDescription());
+    }
+
+    public function testGetName(): void
+    {
+      $this->l10n->expects($this->once())
+        ->method('t')
+        ->with('Imagick PHP extension')
+        ->willReturn('Imagick PHP extension');
+      $this->assertEquals('Imagick PHP extension', $this->check->getName());
+    }
+
+    public function testGetCategory(): void
+    {
+      $this->assertEquals('system', $this->check->getCategory());
+    }
+  }
+}