| Current Path : /var/www/surf/TYPO3/vendor/typo3/cms-core/Classes/Messaging/ |
| Current File : /var/www/surf/TYPO3/vendor/typo3/cms-core/Classes/Messaging/AbstractMessage.php |
<?php
declare(strict_types=1);
/*
* 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\Core\Messaging;
use TYPO3\CMS\Core\Type\ContextualFeedbackSeverity;
/**
* A class used for any kind of messages.
*/
abstract class AbstractMessage implements \JsonSerializable
{
/**
* @deprecated Use \TYPO3\CMS\Core\Type\ContextualFeedbackSeverity::NOTICE instead
*/
public const NOTICE = -2;
/**
* @deprecated Use \TYPO3\CMS\Core\Type\ContextualFeedbackSeverity::INFO instead
*/
public const INFO = -1;
/**
* @deprecated Use \TYPO3\CMS\Core\Type\ContextualFeedbackSeverity::OK instead
*/
public const OK = 0;
/**
* @deprecated Use \TYPO3\CMS\Core\Type\ContextualFeedbackSeverity::WARNING instead
*/
public const WARNING = 1;
/**
* @deprecated Use \TYPO3\CMS\Core\Type\ContextualFeedbackSeverity::ERROR instead
*/
public const ERROR = 2;
protected string $title = '';
protected string $message = '';
protected ContextualFeedbackSeverity $severity = ContextualFeedbackSeverity::OK;
public function getTitle(): string
{
return $this->title;
}
public function setTitle(string $title): void
{
$this->title = $title;
}
public function getMessage(): string
{
return $this->message;
}
public function setMessage(string $message): void
{
$this->message = $message;
}
/**
* @internal
*/
public function getSeverity(): ContextualFeedbackSeverity
{
return $this->severity;
}
/**
* Sets the message' severity
*
* @param value-of<ContextualFeedbackSeverity>|ContextualFeedbackSeverity $severity
*
* @todo: Change $severity to allow ContextualFeedbackSeverity only in v13
*/
public function setSeverity(int|ContextualFeedbackSeverity $severity = ContextualFeedbackSeverity::OK): void
{
if (is_int($severity)) {
// @deprecated int type for $severity deprecated in v12, will change to Severity only in v13.
$severity = ContextualFeedbackSeverity::transform($severity) ?? ContextualFeedbackSeverity::OK;
}
$this->severity = $severity;
}
/**
* Creates a string representation of the message. Useful for command
* line use.
*
* @return string A string representation of the message.
*/
public function __toString()
{
$title = '';
if ($this->title !== '') {
$title = ' - ' . $this->title;
}
return $this->severity->name . $title . ': ' . $this->message;
}
/**
* @return array Data which can be serialized by json_encode()
*/
public function jsonSerialize(): array
{
return [
'severity' => $this->getSeverity()->value,
'title' => $this->getTitle(),
'message' => $this->getMessage(),
];
}
}