ListUtility.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Extensionmanager\Utility;

use TYPO3\CMS\Core\Package\PackageInterface;
use TYPO3\CMS\Core\Utility\ExtensionManagementUtility;
use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Core\Utility\VersionNumberUtility;
use TYPO3\CMS\Extensionmanager\Domain\Model\Extension;

class ListUtility implements \TYPO3\CMS\Core\SingletonInterface {

    protected $emConfUtility;

    protected $extensionRepository;

    protected $installUtility;

    protected $packageManager;

    protected $signalSlotDispatcher;

    public function getAvailableExtensions() {
        $this->emitPackagesMayHaveChangedSignal();
        $extensions = array();
        foreach ($this->packageManager->getAvailablePackages() as $package) {
            // Only TYPO3 related packages could be handled by the extension manager
            // Composer packages from "Packages" folder will be instantiated as \TYPO3\Flow\Package\Package
            if (!($package instanceof \TYPO3\CMS\Core\Package\PackageInterface)) {
                continue;
            }
            $installationType = $this->getInstallTypeForPackage($package);
            $extensions[$package->getPackageKey()] = array(
                'siteRelPath' => str_replace(PATH_site, '', $package->getPackagePath()),
                'type' => $installationType,
                'key' => $package->getPackageKey(),
                'ext_icon' => ExtensionManagementUtility::getExtensionIcon($package->getPackagePath()),
            );
        }
        return $extensions;
    }

    public function getExtension($extensionKey) {
        return $this->packageManager->getPackage($extensionKey);
    }

    protected function emitPackagesMayHaveChangedSignal() {
        $this->signalSlotDispatcher->dispatch('PackageManagement', 'packagesMayHaveChanged');
    }

    protected function getInstallTypeForPackage(PackageInterface $package) {
        foreach (Extension::returnInstallPaths() as $installType => $installPath) {
            if (GeneralUtility::isFirstPartOfStr($package->getPackagePath(), $installPath)) {
                return $installType;
            }
        }
        return '';
    }

    public function getAvailableAndInstalledExtensions(array $availableExtensions) {
        foreach ($this->packageManager->getActivePackages() as $extKey => $_) {
            if (isset($availableExtensions[$extKey])) {
                $availableExtensions[$extKey]['installed'] = TRUE;
            }
        }
        return $availableExtensions;
    }

    public function enrichExtensionsWithEmConfInformation(array $extensions) {
        foreach ($extensions as $extensionKey => $properties) {
            $emconf = $this->emConfUtility->includeEmConf($properties);
            if ($emconf) {
                $extensions[$extensionKey] = array_merge($emconf, $properties);
            } else {
                unset($extensions[$extensionKey]);
            }
        }
        return $extensions;
    }

    public function enrichExtensionsWithEmConfAndTerInformation(array $extensions) {
        $extensions = $this->enrichExtensionsWithEmConfInformation($extensions);
        foreach ($extensions as $extensionKey => $properties) {
            $terObject = $this->getExtensionTerData($extensionKey, $extensions[$extensionKey]['version']);
            if ($terObject !== null) {
                $extensions[$extensionKey]['terObject'] = $terObject;
                $extensions[$extensionKey]['updateAvailable'] = FALSE;
                $extensions[$extensionKey]['updateToVersion'] = NULL;
                $extensionToUpdate = $this->installUtility->getUpdateableVersion($terObject);
                if ($extensionToUpdate !== false) {
                    $extensions[$extensionKey]['updateAvailable'] = TRUE;
                    $extensions[$extensionKey]['updateToVersion'] = $extensionToUpdate;
                }
            }
        }
        return $extensions;
    }

    protected function getExtensionTerData($extensionKey, $version) {
        $terObject = $this->extensionRepository->findOneByExtensionKeyAndVersion($extensionKey, $version);
        if (!$terObject instanceof Extension) {
            // Version unknown in TER data, try to find extension
            $terObject = $this->extensionRepository->findHighestAvailableVersion($extensionKey);
            if ($terObject instanceof Extension) {
                // Found in TER now, set version information to the known ones, so we can look if there is a newer one
                // Use a cloned object, otherwise wrong information is stored in persistenceManager
                $terObject = clone $terObject;
                $terObject->setVersion($version);
                $terObject->setIntegerVersion(
                    VersionNumberUtility::convertVersionNumberToInteger($terObject->getVersion())
                );
            } else {
                $terObject = NULL;
            }
        }

        return $terObject;
    }

    public function enrichExtensionsWithIconInformation(array $extensions) {
        foreach ($extensions as &$properties) {
            $iInfo = @getimagesize(PATH_site . $properties['siteRelPath'] . $properties['ext_icon']);
            if ($iInfo !== FALSE) {
                $properties['ext_icon_width'] = $iInfo[0];
                $properties['ext_icon_height'] = $iInfo[1];
            } else {
                $properties['ext_icon_width'] = 0;
                $properties['ext_icon_height'] = 0;
            }
        }
        unset($properties);
        return $extensions;
    }

    public function getAvailableAndInstalledExtensionsWithAdditionalInformation() {
        $availableExtensions = $this->getAvailableExtensions();
        $availableAndInstalledExtensions = $this->getAvailableAndInstalledExtensions($availableExtensions);
        return $this->enrichExtensionsWithEmConfAndTerInformation($availableAndInstalledExtensions);
    }
}