1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
|
<?php
/**
* Efficient concatenated text storage.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
* http://www.gnu.org/copyleft/gpl.html
*
* @file
*/
use MediaWiki\MediaWikiServices;
/**
* Pointer object for an item within a CGZ blob stored in the text table.
*
* WARNING: Objects of this class are serialized and permanently stored in the DB.
* Do not change the name or visibility of any property!
*
* Note: the property visibility was changed in 2020 from public to protected.
* This may cause problems in future.
*/
class HistoryBlobStub {
/**
* @var array One-step cache variable to hold base blobs; operations that
* pull multiple revisions may often pull multiple times from the same
* blob. By keeping the last-used one open, we avoid redundant
* unserialization and decompression overhead.
*/
protected static $blobCache = [];
/** @var int */
protected $mOldId;
/** @var string */
protected $mHash;
/** @var string */
protected $mRef;
/**
* @param string $hash The content hash of the text
* @param int $oldid The old_id for the CGZ object
*/
public function __construct( $hash = '', $oldid = 0 ) {
$this->mHash = $hash;
}
/**
* Sets the location (old_id) of the main object to which this object
* points
* @param int $id
*/
public function setLocation( $id ) {
$this->mOldId = $id;
}
/**
* Gets the location of the main object
* @return int
*/
public function getLocation() {
return $this->mOldId;
}
/**
* Sets the location (old_id) of the referring object
* @param string $id
*/
public function setReferrer( $id ) {
$this->mRef = $id;
}
/**
* Gets the location of the referring object
* @return string
*/
public function getReferrer() {
return $this->mRef;
}
/**
* @return string|false
*/
public function getText() {
if ( isset( self::$blobCache[$this->mOldId] ) ) {
$obj = self::$blobCache[$this->mOldId];
} else {
$dbr = MediaWikiServices::getInstance()->getConnectionProvider()->getReplicaDatabase();
$row = $dbr->newSelectQueryBuilder()
->select( [ 'old_flags', 'old_text' ] )
->from( 'text' )
->where( [ 'old_id' => $this->mOldId ] )
->caller( __METHOD__ )->fetchRow();
if ( !$row ) {
return false;
}
$flags = explode( ',', $row->old_flags );
if ( in_array( 'external', $flags ) ) {
$url = $row->old_text;
$parts = explode( '://', $url, 2 );
if ( !isset( $parts[1] ) || $parts[1] == '' ) {
return false;
}
$row->old_text = MediaWikiServices::getInstance()
->getExternalStoreAccess()
->fetchFromURL( $url );
}
if ( !in_array( 'object', $flags ) ) {
return false;
}
if ( in_array( 'gzip', $flags ) ) {
// This shouldn't happen, but a bug in the compress script
// may at times gzip-compress a HistoryBlob object row.
$obj = HistoryBlobUtils::unserialize( gzinflate( $row->old_text ), true );
} else {
$obj = HistoryBlobUtils::unserialize( $row->old_text, true );
}
// Save this item for reference; if pulling many
// items in a row we'll likely use it again.
self::$blobCache = [ $this->mOldId => $obj ];
}
if ( method_exists( $obj, 'getItem' ) ) {
return $obj->getItem( $this->mHash );
}
return false;
}
/**
* Get the content hash
*
* @return string
*/
public function getHash() {
return $this->mHash;
}
}
// Blobs generated by MediaWiki < 1.5 on PHP 4 were serialized with the
// class name coerced to lowercase. We can improve efficiency by adding
// autoload entries for the lowercase variants of these classes (T166759).
// The code below is never executed, but it is picked up by the AutoloadGenerator
// parser, which scans for class_alias() calls.
/*
class_alias( HistoryBlobStub::class, 'historyblobstub' );
*/
|
