Page MenuHomeWickedGov Phorge
Files F5952831

ClientHintsData.php
No OneTemporary
Actions

Size
7 KB
Referenced Files
None
Subscribers
None

ClientHintsData.php
View Options

<?php
namespace MediaWiki\CheckUser\ClientHints;
use JsonSerializable;
use MediaWiki\CheckUser\Services\UserAgentClientHintsManager;
use MediaWiki\Logger\LoggerFactory;
use TypeError;
/**
* Value object for modeling user agent client hints data.
*/
class ClientHintsData implements JsonSerializable {
public const HEADER_TO_CLIENT_HINTS_DATA_PROPERTY_NAME = [
"Sec-CH-UA" => "userAgent",
"Sec-CH-UA-Arch" => "architecture",
"Sec-CH-UA-Bitness" => "bitness",
"Sec-CH-UA-Form-Factor" => "formFactor",
"Sec-CH-UA-Full-Version-List" => "fullVersionList",
"Sec-CH-UA-Mobile" => "mobile",
"Sec-CH-UA-Model" => "model",
"Sec-CH-UA-Platform" => "platform",
"Sec-CH-UA-Platform-Version" => "platformVersion",
"Sec-CH-UA-WoW64" => "woW64"
];
private ?string $architecture;
private ?string $bitness;
private ?array $brands;
private ?string $formFactor;
private ?array $fullVersionList;
private ?bool $mobile;
private ?string $model;
private ?string $platform;
private ?string $platformVersion;
private ?string $userAgent;
private ?bool $woW64;
/**
* @param string|null $architecture
* @param string|null $bitness
* @param string[][]|null $brands
* @param string|null $formFactor
* @param string[][]|null $fullVersionList
* @param bool|null $mobile
* @param string|null $model
* @param string|null $platform
* @param string|null $platformVersion
* @param string|null $userAgent
* @param bool|null $woW64
*/
public function __construct(
?string $architecture,
?string $bitness,
?array $brands,
?string $formFactor,
?array $fullVersionList,
?bool $mobile,
?string $model,
?string $platform,
?string $platformVersion,
?string $userAgent,
?bool $woW64
) {
$this->architecture = $architecture;
$this->bitness = $bitness;
$this->brands = $brands;
$this->formFactor = $formFactor;
$this->fullVersionList = $fullVersionList;
$this->mobile = $mobile;
$this->model = $model;
$this->platform = $platform;
$this->platformVersion = $platformVersion;
$this->userAgent = $userAgent;
$this->woW64 = $woW64;
}
/**
* Given an array of data received from the client-side JavaScript API for obtaining
* user agent client hints, construct a new ClientHintsData object.
*
* @see UserAgentClientHintsManager::getBodyValidator
*
* @param array $data
* @return ClientHintsData
* @throws TypeError on invalid data (such as platformVersion being an array).
*/
public static function newFromJsApi( array $data ): ClientHintsData {
// Handle clients sending uaFullVersion in their JS API request (T350316) by adding it to the
// fullVersionList if the fullVersionList is empty or not defined. If fullVersionList is defined,
// then the data is almost certainly duplicated in the already defined fullVersionList so ignore it.
if (
array_key_exists( 'uaFullVersion', $data ) &&
(
!array_key_exists( 'fullVersionList', $data ) ||
!is_array( $data['fullVersionList'] ) ||
!count( $data['fullVersionList'] )
)
) {
if ( !array_key_exists( 'fullVersionList', $data ) ) {
$data['fullVersionList'] = [];
}
$data['fullVersionList'][] = $data['uaFullVersion'];
}
return new self(
$data['architecture'] ?? null,
$data['bitness'] ?? null,
$data['brands'] ?? null,
null,
$data['fullVersionList'] ?? null,
$data['mobile'] ?? null,
$data['model'] ?? null,
$data['platform'] ?? null,
$data['platformVersion'] ?? null,
null,
null
);
}
/**
* Given an array of rows from the useragent_clienthints table,
* construct a new ClientHintsData object.
*
* @param array $rows
* @return ClientHintsData
*/
public static function newFromDatabaseRows( array $rows ): ClientHintsData {
$data = [];
foreach ( $rows as $row ) {
if ( in_array( $row['uach_name'], [ 'brands', 'fullVersionList' ] ) ) {
// There can be multiple client hint values with this name
// for brands and fullVersionList
if ( !array_key_exists( $row['uach_name'], $data ) ) {
$data[$row['uach_name']] = [];
}
// Assume that last space separates version number from brand name (e.g. "NotABrand 123")
// When saving to the DB, we combine the version number and brand name
// with a separator of a space.
$explodedValue = explode( ' ', $row['uach_value'] );
if ( count( $explodedValue ) > 1 ) {
$versionNumber = array_pop( $explodedValue );
$brandName = implode( ' ', $explodedValue );
$data[$row['uach_name']][] = [
"brand" => $brandName,
"version" => $versionNumber
];
} else {
// No space was found, therefore keep the value as is.
$data[$row['uach_name']][] = $row['uach_value'];
}
} else {
$value = $row['uach_value'];
// Convert "0" and "1" to their boolean values
// for "mobile" and "woW64"
if ( in_array( $row['uach_name'], [ 'mobile', 'woW64' ] ) ) {
$value = boolval( $value );
}
$data[$row['uach_name']] = $value;
}
}
return new ClientHintsData(
$data['architecture'] ?? null,
$data['bitness'] ?? null,
$data['brands'] ?? null,
$data['formFactor'] ?? null,
$data['fullVersionList'] ?? null,
$data['mobile'] ?? null,
$data['model'] ?? null,
$data['platform'] ?? null,
$data['platformVersion'] ?? null,
$data['userAgent'] ?? null,
$data['woW64'] ?? null
);
}
/**
* @return array[]
* An array of arrays containing maps of uach_name => uach_value items
* to insert into the cu_useragent_clienthints table.
*/
public function toDatabaseRows(): array {
$rows = [];
foreach ( $this->jsonSerialize() as $key => $value ) {
if ( !is_array( $value ) ) {
if ( $value === "" || $value === null ) {
continue;
}
if ( is_bool( $value ) ) {
$value = $value ? "1" : "0";
}
$value = trim( $value );
$rows[] = [ 'uach_name' => $key, 'uach_value' => $value ];
} else {
// Some values are arrays, for example:
// [
// "brand": "Not.A/Brand",
// "version": "8"
// ],
// We transform these by joining brand/version with a space, e.g. "Not.A/Brand 8"
$itemsAsString = [];
foreach ( $value as $item ) {
if ( is_array( $item ) ) {
// Sort so "brand" is always first and then "version".
ksort( $item );
// Trim the data to remove leading and trailing spaces.
$item = array_map( static function ( $value ) {
return trim( $value );
}, $item );
// Convert arrays to a string by imploding
$itemsAsString[] = implode( ' ', $item );
} elseif ( is_string( $item ) || is_numeric( $item ) ) {
// Allow integers, floats and strings to be stored
// as their string representation.
//
// Trim the data to remove leading and trailing spaces.
$item = strval( $item );
$itemsAsString[] = trim( $item );
}
}
// Remove any duplicates
$itemsAsString = array_unique( $itemsAsString );
// Limit to 10 maximum items
if ( count( $itemsAsString ) > 10 ) {
LoggerFactory::getInstance( 'CheckUser' )->info(
"ClientHintsData object has too many items in array for {key}. " .
"Truncated to 10 items.",
[ $key ]
);
// array_splice modifies the array in place, by taking the array
// as the first argument via reference. The return value is
// the elements that were "extracted", which in this case are
// the items to be ignored.
array_splice( $itemsAsString, 10 );
}
// Now convert to DB rows
foreach ( $itemsAsString as $item ) {
$rows[] = [
'uach_name' => $key,
'uach_value' => $item
];
}
}
}
return $rows;
}
/** @inheritDoc */
public function jsonSerialize(): array {
return [
'architecture' => $this->architecture,
'bitness' => $this->bitness,
'brands' => $this->brands,
'formFactor' => $this->formFactor,
'fullVersionList' => $this->fullVersionList,
'mobile' => $this->mobile,
'model' => $this->model,
'platform' => $this->platform,
'platformVersion' => $this->platformVersion,
'userAgent' => $this->userAgent,
'woW64' => $this->woW64,
];
}
}

File Metadata

Mime Type
text/x-php
Expires
Oct 3 2026, 01:45 (4 w, 3 d ago)
Storage Engine
local-disk
Storage Format
Raw Data
Storage Handle
ff/76/fa5c5409e24098dc273b0bab28c2
Default Alt Text
ClientHintsData.php (7 KB)

Event Timeline