DevtoolsMissingLanguageItem.class.php

<?php

namespace wcf\data\devtools\missing\language\item;

use wcf\data\DatabaseObject;
use wcf\data\language\Language;
use wcf\system\language\LanguageFactory;
use wcf\system\WCF;

/**
 * Represents a missing language item log entry.
 *
 * @author  Matthias Schmidt
 * @copyright   2001-2020 WoltLab GmbH
 * @license GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
 * @since   5.3
 *
 * @property-read   int $itemID     unique id of the missing language item log entry
 * @property-read   ?int $languageID id of the language the missing language item was requested for
 * @property-read   string $languageItem   name of the missing language item
 * @property-read   int $lastTime   timestamp of the last time the missing language item was requested
 * @property-read   string $stackTrace stack trace of how the missing language item was requested for the last time
 */
class DevtoolsMissingLanguageItem extends DatabaseObject
{
    /**
     * Returns the language the missing language item was requested for or `null` if the language
     * does not exist anymore.
     *
     * @return  null|Language
     */
    public function getLanguage()
    {
        if ($this->languageID === null) {
            return null;
        }

        return LanguageFactory::getInstance()->getLanguage($this->languageID);
    }

    /**
     * Returns the formatted stack trace of how the missing language item was requested for the
     * last time.
     *
     * @return  string
     */
    public function getStackTrace()
    {
        $stackTrace = \json_decode($this->stackTrace, true, flags: \JSON_THROW_ON_ERROR);

        return WCF::getTPL()->render('wcf', '__devtoolsMissingLanguageItemStackTrace', [
            'stackTrace' => $stackTrace,
        ]);
    }
}