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
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
|
<?php
/**
* Prioritized list of file repositories
* @addtogroup filerepo
*/
class RepoGroup {
var $localRepo, $foreignRepos, $reposInitialised = false;
var $localInfo, $foreignInfo;
protected static $instance;
/**
* Get a RepoGroup instance. At present only one instance of RepoGroup is
* needed in a MediaWiki invocation, this may change in the future.
*/
static function singleton() {
if ( self::$instance ) {
return self::$instance;
}
global $wgLocalFileRepo, $wgForeignFileRepos;
self::$instance = new RepoGroup( $wgLocalFileRepo, $wgForeignFileRepos );
return self::$instance;
}
/**
* Destroy the singleton instance, so that a new one will be created next
* time singleton() is called.
*/
static function destroySingleton() {
self::$instance = null;
}
/**
* Set the singleton instance to a given object
*/
static function setSingleton( $instance ) {
self::$instance = $instance;
}
/**
* Construct a group of file repositories.
* @param array $data Array of repository info arrays.
* Each info array is an associative array with the 'class' member
* giving the class name. The entire array is passed to the repository
* constructor as the first parameter.
*/
function __construct( $localInfo, $foreignInfo ) {
$this->localInfo = $localInfo;
$this->foreignInfo = $foreignInfo;
}
/**
* Search repositories for an image.
* You can also use wfGetFile() to do this.
* @param mixed $title Title object or string
* @param mixed $time The 14-char timestamp the file should have
* been uploaded, or false for the current version
* @return File object or false if it is not found
*/
function findFile( $title, $time = false ) {
if ( !$this->reposInitialised ) {
$this->initialiseRepos();
}
$image = $this->localRepo->findFile( $title, $time );
if ( $image ) {
return $image;
}
foreach ( $this->foreignRepos as $repo ) {
$image = $repo->findFile( $title, $time );
if ( $image ) {
return $image;
}
}
return false;
}
/**
* Interface for FileRepo::checkRedirect()
*/
function checkRedirect( $title ) {
if ( !$this->reposInitialised ) {
$this->initialiseRepos();
}
$redir = $this->localRepo->checkRedirect( $title );
if( $redir ) {
return $redir;
}
foreach ( $this->foreignRepos as $repo ) {
$redir = $repo->checkRedirect( $title );
if ( $redir ) {
return $redir;
}
}
return false;
}
/**
* Get the repo instance with a given key.
*/
function getRepo( $index ) {
if ( !$this->reposInitialised ) {
$this->initialiseRepos();
}
if ( $index === 'local' ) {
return $this->localRepo;
} elseif ( isset( $this->foreignRepos[$index] ) ) {
return $this->foreignRepos[$index];
} else {
return false;
}
}
/**
* Get the repo instance by its name
*/
function getRepoByName( $name ) {
if ( !$this->reposInitialised ) {
$this->initialiseRepos();
}
foreach ( $this->foreignRepos as $key => $repo ) {
if ( $repo->name == $name)
return $repo;
}
return false;
}
/**
* Get the local repository, i.e. the one corresponding to the local image
* table. Files are typically uploaded to the local repository.
*/
function getLocalRepo() {
return $this->getRepo( 'local' );
}
/**
* Initialise the $repos array
*/
function initialiseRepos() {
if ( $this->reposInitialised ) {
return;
}
$this->reposInitialised = true;
$this->localRepo = $this->newRepo( $this->localInfo );
$this->foreignRepos = array();
foreach ( $this->foreignInfo as $key => $info ) {
$this->foreignRepos[$key] = $this->newRepo( $info );
}
}
/**
* Create a repo class based on an info structure
*/
protected function newRepo( $info ) {
$class = $info['class'];
return new $class( $info );
}
/**
* Split a virtual URL into repo, zone and rel parts
* @return an array containing repo, zone and rel
*/
function splitVirtualUrl( $url ) {
if ( substr( $url, 0, 9 ) != 'mwrepo://' ) {
throw new MWException( __METHOD__.': unknown protoocl' );
}
$bits = explode( '/', substr( $url, 9 ), 3 );
if ( count( $bits ) != 3 ) {
throw new MWException( __METHOD__.": invalid mwrepo URL: $url" );
}
return $bits;
}
function getFileProps( $fileName ) {
if ( FileRepo::isVirtualUrl( $fileName ) ) {
list( $repoName, /* $zone */, /* $rel */ ) = $this->splitVirtualUrl( $fileName );
if ( $repoName === '' ) {
$repoName = 'local';
}
$repo = $this->getRepo( $repoName );
return $repo->getFileProps( $fileName );
} else {
return File::getPropsFromPath( $fileName );
}
}
}
|
