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
|
<?php
use MediaWiki\MediaWikiServices;
use MediaWiki\User\ActorStoreFactory;
use MediaWiki\User\UserIdentity;
use Wikimedia\Rdbms\IDatabase;
/**
* This is not intended to be a long-term part of MediaWiki; it will be
* deprecated and removed once actor migration is complete.
*
* @since 1.31
* @since 1.34 Use with 'ar_user', 'img_user', 'oi_user', 'fa_user',
* 'rc_user', 'log_user', and 'ipb_by' is deprecated. Callers should
* reference the corresponding actor fields directly.
* @deprecated since 1.39
*/
class ActorMigration extends ActorMigrationBase {
/**
* Constant for extensions to feature-test whether $wgActorTableSchemaMigrationStage
* (in MW <1.34) expects MIGRATION_* or SCHEMA_COMPAT_*
*/
public const MIGRATION_STAGE_SCHEMA_COMPAT = 1;
/**
* Field information
* @see ActorMigrationBase::getFieldInfo()
*/
public const FIELD_INFOS = [
// Deprecated since 1.39
'rev_user' => [
'tempTable' => [
'table' => 'revision_actor_temp',
'pk' => 'revactor_rev',
'field' => 'revactor_actor',
'joinPK' => 'rev_id',
'extra' => [
'revactor_timestamp' => 'rev_timestamp',
'revactor_page' => 'rev_page',
],
]
],
// Deprecated since 1.34
'ar_user' => [
'deprecatedVersion' => '1.37',
],
// Deprecated since 1.34
'img_user' => [
'deprecatedVersion' => '1.37',
],
// Deprecated since 1.34
'oi_user' => [
'deprecatedVersion' => '1.37',
],
// Deprecated since 1.34
'fa_user' => [
'deprecatedVersion' => '1.37',
],
// Deprecated since 1.34
'rc_user' => [
'deprecatedVersion' => '1.37',
],
// Deprecated since 1.34
'log_user' => [
'deprecatedVersion' => '1.37',
],
// Deprecated since 1.34
'ipb_by' => [
'deprecatedVersion' => '1.37',
'textField' => 'ipb_by_text',
'actorField' => 'ipb_by_actor'
]
];
/**
* Static constructor
* @return self
*/
public static function newMigration() {
return MediaWikiServices::getInstance()->getActorMigration();
}
/**
* @internal
*
* @param int $stage
* @param ActorStoreFactory $actorStoreFactory
*/
public function __construct(
$stage,
ActorStoreFactory $actorStoreFactory
) {
if ( $stage & SCHEMA_COMPAT_OLD ) {
throw new InvalidArgumentException(
'The old actor table schema is no longer supported' );
}
parent::__construct(
self::FIELD_INFOS,
$stage,
$actorStoreFactory
);
}
/**
* @inheritDoc
* @deprecated since 1.39 Use `{table} JOIN actor ON {table_prefix}_actor = actor_id`
* E.g. for key=rev_user, use `revision JOIN actor ON rev_actor = actor_id`
*/
public function getJoin( $key ) {
return parent::getJoin( $key );
}
/**
* @inheritDoc
* @deprecated since 1.39 Use `{table_prefix}_actor IN ({list of actor IDs})`.
* E.g. for key=rev_user, use `rev_actor IN ({list of actor IDs})`.
* Use `MediaWikiServices::getInstance()->getActorNormalization()
* ->findActorId( $user, $db )` to get the actor ID for a given user.
*/
public function getWhere( IDatabase $db, $key, $users, $useId = true ) {
return parent::getWhere( $db, $key, $users, $useId );
}
/**
* @inheritDoc
* @deprecated since 1.39 Use `[ '{table_prefix}_actor' => MediaWikiServices::getInstance()
* ->getActorNormalization()->acquireActorId( $user, $dbw ) ]`
* E.g. for key=log_user, use `[ 'log_actor' => ... ]`
*/
public function getInsertValues( IDatabase $dbw, $key, UserIdentity $user ) {
return parent::getInsertValues( $dbw, $key, $user );
}
/**
* @inheritDoc
* @deprecated since 1.39 Use same replacement as getInsertValues().
*/
public function getInsertValuesWithTempTable( IDatabase $dbw, $key, UserIdentity $user ) {
return parent::getInsertValuesWithTempTable( $dbw, $key, $user );
}
}
|
