show available github release only if newer version exists (#4037)

src/Controller/DoctorController.php

@@ -9,6 +9,7 @@
 
 namespace App\Controller;
 
+use App\Constants;
 use App\Utils\FileHelper;
 use App\Utils\PageSetup;
 use App\Utils\ReleaseVersion;
@@ -87,6 +88,13 @@ final class DoctorController extends AbstractController
         $page = new PageSetup('Doctor');
         $page->setHelp('doctor.html');
 
+        $latestRelease = $this->getNextUpdateVersion();
+        if (\is_array($latestRelease) && \array_key_exists('version', $latestRelease)) {
+            if (version_compare(Constants::VERSION, (string) $latestRelease['version']) >= 0) {
+                $latestRelease = null;
+            }
+        }
+
         return $this->render('doctor/index.html.twig', [
             'page_setup' => $page,
             'modules' => get_loaded_extensions(),
@@ -100,7 +108,7 @@ final class DoctorController extends AbstractController
             'logLines' => $logLines,
             'logSize' => $this->getLogSize(),
             'composer' => $this->getComposerPackages(),
-            'release' => $this->getNextUpdateVersion()
+            'release' => $latestRelease
         ]);
     }
 
@@ -109,6 +117,7 @@ final class DoctorController extends AbstractController
      */
     private function getComposerPackages(): array
     {
+        /** @var array<string, string> $versions */
         $versions = [];
 
         if (class_exists(InstalledVersions::class)) {
@@ -313,6 +322,9 @@ final class DoctorController extends AbstractController
         return $phpInfo;
     }
 
+    /**
+     * @return array{'version': string, 'date': \DateTimeInterface, 'url': string, 'download': string, 'content': string}|null
+     */
     private function getNextUpdateVersion(): ?array
     {
         return $this->cache->get('kimai.update_release', function (ItemInterface $item) {

src/Utils/ReleaseVersion.php

@@ -22,6 +22,8 @@ final class ReleaseVersion
      * Get all releases from GitHub.
      *
      * @throws \Exception
+     * @return array|null
+     * @return array<string, array{'version': string, 'date': \DateTimeInterface, 'url': string, 'download': string, 'content': string}>
      * @return array
      */
     private function getReleasesFromGithub(): array
@@ -93,7 +95,7 @@ final class ReleaseVersion
      * - content (string, release notes)
      *
      * @param bool $compatible
-     * @return array|null
+     * @return array{'version': string, 'date': \DateTimeInterface, 'url': string, 'download': string, 'content': string}|null
      * @throws \Exception
      */
     public function getLatestReleaseFromGithub(bool $compatible): ?array