Extension.php

Go to the documentation of this file.

<?php
 
/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */
 
namespace ‪TYPO3\CMS\Extensionmanager\Domain\Model;
 
use ‪TYPO3\CMS\Core\Core\Environment;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
use ‪TYPO3\CMS\Core\Utility\MathUtility;
use ‪TYPO3\CMS\Extbase\DomainObject\AbstractEntity;
 
class ‪Extension extends ‪AbstractEntity
{
    public const ‪DISTRIBUTION_CATEGORY = 10;
 
    protected static ‪$defaultCategories = [
        0 => 'be',
        1 => 'module',
        2 => 'fe',
        3 => 'plugin',
        4 => 'misc',
        5 => 'services',
        6 => 'templates',
        8 => 'doc',
        9 => 'example',
        self::DISTRIBUTION_CATEGORY => 'distribution',
    ];
 
    protected static ‪$defaultStates = [
        0 => 'alpha',
        1 => 'beta',
        2 => 'stable',
        3 => 'experimental',
        4 => 'test',
        5 => 'obsolete',
        6 => 'excludeFromUpdates',
        7 => 'deprecated',
        999 => 'n/a',
    ];
 
    protected ‪$extensionKey = '';
 
    protected ‪$version = '';
 
    protected ‪$integerVersion = 0;
 
    protected ‪$title = '';
 
    protected ‪$description = '';
 
    protected ‪$state = 0;
 
    protected ‪$category = 0;
 
    protected ‪$lastUpdated;
 
    protected ‪$updateComment = '';
 
    protected ‪$authorName = '';
 
    protected ‪$authorEmail = '';
 
    protected ‪$currentVersion = false;
 
    protected ‪$md5hash = '';
 
    protected ‪$reviewState;
 
    protected ‪$alldownloadcounter;
 
    protected ‪$serializedDependencies = '';
 
    protected ‪$dependencies;
 
    protected ‪$documentationLink = '';
 
    protected ‪$distributionImage = '';
 
    protected ‪$distributionWelcomeImage = '';
 
    protected ‪$remote;
 
    protected ‪$position = 0;
 
    public function ‪setAuthorEmail(‪$authorEmail)
    {
        $this->authorEmail = ‪$authorEmail;
    }
 
    public function ‪getAuthorEmail()
    {
        return ‪$this->authorEmail;
    }
 
    public function ‪setAuthorName(‪$authorName)
    {
        $this->authorName = ‪$authorName;
    }
 
    public function ‪getAuthorName()
    {
        return ‪$this->authorName;
    }
 
    public function ‪setCategory(‪$category)
    {
        $this->category = ‪$category;
    }
 
    public function ‪getCategory()
    {
        return ‪$this->category;
    }
 
    public function ‪getCategoryString()
    {
        $categoryString = '';
        if (isset(self::$defaultCategories[$this->‪getCategory()])) {
            $categoryString = self::$defaultCategories[$this->‪getCategory()];
        }
        return $categoryString;
    }
 
    public function ‪getCategoryIndexFromStringOrNumber(‪$category)
    {
        $categoryIndex = 4;
        if (‪MathUtility::canBeInterpretedAsInteger(‪$category)) {
            $categoryIndex = (int)‪$category;
            if ($categoryIndex < 0 || $categoryIndex > 10) {
                $categoryIndex = 4;
            }
        } elseif (is_string(‪$category)) {
            $categoryIndex = array_search(‪$category, self::$defaultCategories);
            if ($categoryIndex === false) {
                $categoryIndex = 4;
            }
        }
        return (int)$categoryIndex;
    }
 
    public function ‪setDescription(‪$description)
    {
        $this->‪description = ‪$description;
    }
 
    public function ‪getDescription()
    {
        return ‪$this->description;
    }
 
    public function ‪setExtensionKey(‪$extensionKey)
    {
        $this->extensionKey = ‪$extensionKey;
    }
 
    public function ‪getExtensionKey()
    {
        return ‪$this->extensionKey;
    }
 
    public function ‪setLastUpdated(\DateTime ‪$lastUpdated)
    {
        $this->lastUpdated = ‪$lastUpdated;
    }
 
    public function ‪getLastUpdated()
    {
        return ‪$this->lastUpdated;
    }
 
    public function ‪setState(‪$state)
    {
        $this->state = ‪$state;
    }
 
    public function ‪getState()
    {
        return ‪$this->state;
    }
 
    public function ‪getStateString()
    {
        $stateString = '';
        if (isset(self::$defaultStates[$this->‪getState()])) {
            $stateString = self::$defaultStates[$this->‪getState()];
        }
        return $stateString;
    }
 
    public function ‪getDefaultState(‪$state = null)
    {
        $defaultState = '';
        if (‪$state === null) {
            $defaultState = ‪self::$defaultStates;
        } else {
            if (is_string(‪$state)) {
                $stateIndex = array_search(strtolower(‪$state), self::$defaultStates);
                if ($stateIndex === false) {
                    // default state
                    $stateIndex = 999;
                }
                $defaultState = $stateIndex;
            } else {
                if (is_int(‪$state) && ‪$state >= 0) {
                    if (array_key_exists(‪$state, self::$defaultStates)) {
                        $stateTitle = self::$defaultStates[‪$state];
                    } else {
                        // default state
                        $stateTitle = 'n/a';
                    }
                    $defaultState = $stateTitle;
                }
            }
        }
        return $defaultState;
    }
 
    public function ‪setTitle(‪$title)
    {
        $this->title = ‪$title;
    }
 
    public function ‪getTitle()
    {
        return ‪$this->title;
    }
 
    public function ‪setUpdateComment(‪$updateComment)
    {
        $this->updateComment = ‪$updateComment;
    }
 
    public function ‪getUpdateComment()
    {
        return ‪$this->updateComment;
    }
 
    public function ‪setVersion(‪$version)
    {
        $this->version = ‪$version;
    }
 
    public function ‪getVersion()
    {
        return ‪$this->version;
    }
 
    public function ‪setCurrentVersion(‪$currentVersion)
    {
        $this->currentVersion = ‪$currentVersion;
    }
 
    public function ‪getCurrentVersion()
    {
        return ‪$this->currentVersion;
    }
 
    public function ‪setMd5hash(‪$md5hash)
    {
        $this->md5hash = ‪$md5hash;
    }
 
    public function ‪getMd5hash()
    {
        return ‪$this->md5hash;
    }
 
    public static function ‪returnInstallPaths()
    {
        return [
            'System' => ‪Environment::getFrameworkBasePath() . '/',
            'Local' => ‪Environment::getExtensionsPath() . '/',
        ];
    }
 
    public static function ‪returnAllowedInstallTypes()
    {
        $installPaths = ‪self::returnInstallPaths();
        return array_keys($installPaths);
    }
 
    public function ‪setSerializedDependencies(‪$dependencies)
    {
        $this->serializedDependencies = ‪$dependencies;
    }
 
    public function ‪getSerializedDependencies()
    {
        return ‪$this->serializedDependencies;
    }
 
    public function ‪setDependencies(‪$dependencies)
    {
        $this->dependencies = ‪$dependencies;
    }
 
    public function ‪getDependencies()
    {
        if (!is_object($this->dependencies)) {
            $this->‪setDependencies($this->‪convertDependenciesToObjects($this->‪getSerializedDependencies()));
        }
        return ‪$this->dependencies;
    }
 
    public function ‪getTypo3Dependency(): ?Dependency
    {
        foreach ($this->‪getDependencies() as $dependency) {
            if ($dependency->getIdentifier() === 'typo3') {
                return $dependency;
            }
        }
        return null;
    }
 
    public function ‪addDependency(‪Dependency $dependency)
    {
        $this->dependencies->attach($dependency);
    }
 
    public function ‪setIntegerVersion(‪$integerVersion)
    {
        $this->integerVersion = ‪$integerVersion;
    }
 
    public function ‪getIntegerVersion()
    {
        return ‪$this->integerVersion;
    }
 
    public function ‪setReviewState(‪$reviewState)
    {
        $this->reviewState = ‪$reviewState;
    }
 
    public function ‪getReviewState()
    {
        return ‪$this->reviewState;
    }
 
    public function ‪setPosition(‪$position)
    {
        $this->position = ‪$position;
    }
 
    public function ‪getPosition()
    {
        return ‪$this->position;
    }
 
    public function ‪setAlldownloadcounter(‪$alldownloadcounter)
    {
        $this->alldownloadcounter = ‪$alldownloadcounter;
    }
 
    public function ‪getAlldownloadcounter()
    {
        return ‪$this->alldownloadcounter;
    }
 
    public function ‪getDocumentationLink(): string
    {
        return ‪$this->documentationLink;
    }
 
    public function ‪setDocumentationLink(string ‪$documentationLink): void
    {
        $this->documentationLink = ‪$documentationLink;
    }
 
    public function ‪getRemoteIdentifier(): string
    {
        return ‪$this->remote;
    }
 
    public static function ‪createFromExtensionArray(array $extensionArray): self
    {
        $extension = GeneralUtility::makeInstance(self::class);
        $extension->setExtensionKey($extensionArray['key']);
        if (isset($extensionArray['version'])) {
            $extension->setVersion($extensionArray['version']);
        }
        $extension->remote = $extensionArray['remote'] ?? 'ter';
        if (isset($extensionArray['constraints'])) {
            $extension->setDependencies($extension->convertDependenciesToObjects(is_array($extensionArray['constraints']) ? serialize($extensionArray['constraints']) : $extensionArray['constraints']));
        }
        return $extension;
    }
 
    protected function ‪convertDependenciesToObjects(string ‪$dependencies): \SplObjectStorage
    {
        $dependenciesObject = new \SplObjectStorage();
        $unserializedDependencies = unserialize(‪$dependencies, ['allowed_classes' => false]);
        if (!is_array($unserializedDependencies)) {
            return $dependenciesObject;
        }
        foreach ($unserializedDependencies as $dependencyType => $dependencyValues) {
            // Dependencies might be given as empty string, e.g. conflicts => ''
            if (!is_array($dependencyValues)) {
                continue;
            }
            if (!$dependencyType) {
                continue;
            }
            foreach ($dependencyValues as $dependency => $versionConstraint) {
                if ($dependency) {
                    $dependencyObject = ‪Dependency::createFromEmConf((string)$dependency, $versionConstraint, (string)$dependencyType);
                    $dependenciesObject->attach($dependencyObject);
                }
            }
        }
        return $dependenciesObject;
    }
 
    public function ‪setDistributionImage(string $imageUrl): void
    {
        $this->distributionImage = $imageUrl;
    }
 
    public function ‪getDistributionImage(): string
    {
        return ‪$this->distributionImage;
    }
 
    public function ‪setDistributionWelcomeImage(string $imageUrl): void
    {
        $this->distributionWelcomeImage = $imageUrl;
    }
 
    public function ‪getDistributionWelcomeImage(): string
    {
        return ‪$this->distributionWelcomeImage;
    }
}