Thijs/wiki.techinc.nl
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

ParserOutput: point to documentation for serialization compatibility.

Browse source 
Any changes to the way ParserOutput is serialized must follow the
instructions at
<https://www.mediawiki.org/wiki/Manual:Parser_cache/Serialization_compatibility>.

Change-Id: Ic16a6804ca0a65f8f9abbc3112359cc239febde3
This commit is contained in:
daniel 2023-01-03 19:08:22 +01:00
parent e3a6741ec1
commit f2febebb30
2 changed files with 12 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
includes/parser/CacheTime.php
View file

@ -254,6 +254,9 @@ class CacheTime implements ParserCacheMetadata, JsonUnserializable {
* @return array
*/
protected function toJsonArray(): array {
// WARNING: When changing how this class is serialized, follow the instructions
// at <https://www.mediawiki.org/wiki/Manual:Parser_cache/Serialization_compatibility>!
return [
'ParseUsedOptions' => $this->mParseUsedOptions,
'CacheExpiry' => $this->mCacheExpiry,
@ -274,6 +277,9 @@ class CacheTime implements ParserCacheMetadata, JsonUnserializable {
* @param array $jsonData
*/
protected function initFromJson( JsonUnserializer $unserializer, array $jsonData ) {
// WARNING: When changing how this class is serialized, follow the instructions
// at <https://www.mediawiki.org/wiki/Manual:Parser_cache/Serialization_compatibility>!
if ( array_key_exists( 'AccessedOptions', $jsonData ) ) {
// Backwards compatibility for ParserOutput
$this->mParseUsedOptions = $jsonData['AccessedOptions'] ?: [];

6
includes/parser/ParserOutput.php
View file

@ -2419,6 +2419,9 @@ class ParserOutput extends CacheTime implements ContentMetadataCollector {
* @return array
*/
protected function toJsonArray(): array {
// WARNING: When changing how this class is serialized, follow the instructions
// at <https://www.mediawiki.org/wiki/Manual:Parser_cache/Serialization_compatibility>!
$data = [
'Text' => $this->mText,
'LanguageLinks' => $this->mLanguageLinks,
@ -2493,6 +2496,9 @@ class ParserOutput extends CacheTime implements ContentMetadataCollector {
protected function initFromJson( JsonUnserializer $unserializer, array $jsonData ): void {
parent::initFromJson( $unserializer, $jsonData );
// WARNING: When changing how this class is serialized, follow the instructions
// at <https://www.mediawiki.org/wiki/Manual:Parser_cache/Serialization_compatibility>!
$this->mText = $jsonData['Text'];
$this->mLanguageLinks = $jsonData['LanguageLinks'];
$this->mCategories = $jsonData['Categories'];