| Server IP : 167.235.224.122 / Your IP : 216.73.216.110 Web Server : Apache/2.4.58 (Ubuntu) System : Linux newplayground 6.8.0-136-generic #136-Ubuntu SMP PREEMPT_DYNAMIC Wed Jul 1 21:33:11 UTC 2026 aarch64 User : deploy ( 1000) PHP Version : 8.4.23 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : OFF Directory : /var/www/html/wiki/extensions/SemanticMediaWiki/src/ |
Upload File : |
<?php
namespace SMW;
use Onoi\Cache\Cache;
use SMW\Localizer\Message;
/**
* @license GNU GPL v2
* @since 2.4
*
* @author mwjames
*/
class PropertyAliasFinder {
/**
* Identifies the cache namespace
*/
const CACHE_NAMESPACE = 'smw:property:alias';
/**
* Identifies the cache TTL (one week)
*/
const CACHE_TTL = 604800;
/**
* @var Cache
*/
private $cache;
/**
* Array with entries "property alias" => "property id"
*
* @var string[]
*/
private $propertyAliases = [];
/**
* @var string[]
*/
private $propertyAliasesByMsgKey = [];
/**
* @var string[]
*/
private $canonicalPropertyAliases = [];
/**
* @var string
*/
private $contentLanguageCode = 'en';
/**
* @since 2.4
*
* @param Cache $cache
* @param array $propertyAliases
* @param array $canonicalPropertyAliases
*/
public function __construct( Cache $cache, array $propertyAliases = [], array $canonicalPropertyAliases = [] ) {
$this->cache = $cache;
$this->canonicalPropertyAliases = $canonicalPropertyAliases;
foreach ( $propertyAliases as $alias => $id ) {
$this->registerAliasByFixedLabel( $id, $alias );
}
}
/**
* @since 3.1
*
* @param string $contentLanguageCode
*/
public function setContentLanguageCode( $contentLanguageCode ) {
$this->contentLanguageCode = $contentLanguageCode;
}
/**
* @since 2.4
*
* @return array
*/
public function getKnownPropertyAliases() {
return $this->propertyAliases;
}
/**
* @since 2.4
*
* @return array
*/
public function getKnownPropertyAliasesWithMsgKey() {
return $this->propertyAliasesByMsgKey;
}
/**
* @since 3.0
*
* @param string $languageCode
*
* @return array
*/
public function getKnownPropertyAliasesByLanguageCode( $languageCode = 'en' ) {
$key = smwfCacheKey(
self::CACHE_NAMESPACE,
[
$languageCode,
$this->propertyAliasesByMsgKey
]
);
if ( ( $propertyAliases = $this->cache->fetch( $key ) ) !== false ) {
return $propertyAliases;
}
$propertyAliases = [];
foreach ( $this->propertyAliasesByMsgKey as $msgKey => $id ) {
$propertyAliases[Message::get( $msgKey, Message::TEXT, $languageCode )] = $id;
}
$this->cache->save( $key, $propertyAliases, self::CACHE_TTL );
return $propertyAliases;
}
/**
* Add a new alias label to an existing property ID. Note that every ID
* should have a primary label.
*
* @param string $id string
* @param string $label
*/
public function registerAliasByFixedLabel( $id, $label ) {
$label = (string)$label;
// Prevent an extension to register an already known
// label
if ( isset( $this->canonicalPropertyAliases[$label] ) && $this->canonicalPropertyAliases[$label] !== $id ) {
return;
}
// Indicates an untranslated MW message key
if ( $label !== '' && $label[0] === '<' ) {
return null;
}
$this->propertyAliases[$label] = $id;
}
/**
* Register an alias using a message key to allow fetching localized
* labels dynamically.
*
* @since 2.4
*
* @param string $id
* @param string $msgKey
*/
public function registerAliasByMsgKey( $id, $msgKey ) {
$this->propertyAliasesByMsgKey[$msgKey] = $id;
// Make sure the label is resolved and registered immediately
// for the content language
$this->registerAliasByFixedLabel(
$id,
Message::get( $msgKey, Message::TEXT, $this->contentLanguageCode )
);
}
/**
* @since 2.4
*
* @param string $id
*
* @return string|bool
*/
public function findCanonicalPropertyAliasById( $id ) {
return array_search( $id, $this->canonicalPropertyAliases );
}
/**
* @since 2.4
*
* @param string $id
*
* @return string|bool
*/
public function findPropertyAliasById( $id ) {
return array_search( $id, $this->propertyAliases );
}
/**
* Find and return the ID for the pre-defined property of the given
* local label. If the label does not belong to a pre-defined property,
* return false.
*
* @param string $alias
*
* @return string|bool
*/
public function findPropertyIdByAlias( $alias ) {
if ( isset( $this->propertyAliases[$alias] ) ) {
return $this->propertyAliases[$alias];
} elseif ( isset( $this->canonicalPropertyAliases[$alias] ) ) {
return $this->canonicalPropertyAliases[$alias];
}
return false;
}
}