3 * Copyright (C) 2006 Daniel Kinzler, brightbyte.de
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
21 * @subpackage Maintenance
24 $optionsWithArgs = array( 'target' );
26 require_once( 'commandLine.inc' );
28 class ExtensionInstaller
{
34 function ExtensionInstaller( $name, $source, $target ) {
36 $this->source
= $source;
37 $this->target
= realpath( $target );
38 $this->extdir
= "$target/extensions";
39 $this->dir
= "{$this->extdir}/$name";
40 $this->incpath
= "extensions/$name";
42 #TODO: allow a subdir different from "extensions"
43 #TODO: allow a config file different from "LocalSettings.php"
46 function note( $msg ) {
50 function warn( $msg ) {
51 print "WARNING: $msg\n";
54 function error( $msg ) {
55 print "ERROR: $msg\n";
58 function prompt( $msg ) {
59 if ( function_exists( 'readline' ) ) {
60 $s = readline( $msg );
63 if ( !@$this->stdin
) $this->stdin
= fopen( 'php://stdin', 'r' );
64 if ( !$this->stdin
) die( "Failed to open stdin for user interaction!\n" );
69 $s = fgets( $this->stdin
);
76 function confirm( $msg ) {
78 $s = $this->prompt( $msg . " [yes/no]: ");
79 $s = strtolower( trim($s) );
81 if ( $s == 'yes' ||
$s == 'y' ) return true;
82 else if ( $s == 'no' ||
$s == 'n' ) return false;
83 else print "bad response: $s\n";
87 function deleteContents( $dir ) {
88 $ff = glob( $dir . "/*" );
91 foreach ( $ff as $f ) {
92 if ( is_dir( $f ) ) $this->deleteContents( $f );
97 function copyDir( $dir, $tgt ) {
98 $d = $tgt . '/' . basename( $dir );
100 if ( !file_exists( $d ) ) {
103 $this->error( "failed to create director $d" );
108 $ff = glob( $dir . "/*" );
109 if ( $ff === false ||
$ff === NULL ) return false;
111 foreach ( $ff as $f ) {
112 if ( is_dir( $f ) ) {
113 $ok = $this->copyDir( $f, $d );
114 if ( !$ok ) return false;
117 $t = $d . '/' . basename( $f );
118 $ok = copy( $f, $t );
121 $this->error( "failed to copy $f to $t" );
130 function fetchExtension( ) {
131 if ( file_exists( $this->dir
) && glob( $this->dir
. "/*" )
132 && realpath( $this->source
) != $this->dir
) {
134 if ( $this->confirm( "{$this->dir} exists and is not empty.\nDelete all files in that directory?" ) ) {
135 $this->deleteContents( $this->dir
);
142 preg_match( '!([-\w]+://)?.*?(\.[-\w\d.]+)?$!', $this->source
, $m );
145 if ( $ext ) $ext = strtolower( $ext );
147 $src = $this->source
;
149 #TODO: check that the required program is available.
150 #may be used: tar, unzip, svn
152 if ( $proto && $ext ) { #remote file
153 $tmp = wfTempDir() . '/' . basename( $src );
155 $this->note( "fetching {$this->source}..." );
156 $ok = copy( $src, $tmp );
159 $this->error( "failed to download {$src}" );
167 if ( $proto ) { #assume SVN repository
168 $this->note( "SVN checkout of $src..." );
169 wfShellExec( 'svn co ' . escapeshellarg( $src ) . ' ' . escapeshellarg( $this->dir
), $code );
172 $this->error( "checkout failed for $src!" );
176 else { #local file or directory
177 $src = realpath ( $src );
179 if ( !file_exists( $src ) ) {
180 $this->error( "file not found: {$this->source}" );
184 if ( $ext === NULL ||
$ext === '') { #local dir
185 if ( $src == $this->dir
) {
186 $this->note( "files are already in the extension dir" );
190 $this->copyDir( $src, $this->extdir
);
192 else if ( $ext == '.tgz' ||
$ext == '.tar.gz' ) { #tgz file
193 $this->note( "extracting $src..." );
194 wfShellExec( 'tar zxvf ' . escapeshellarg( $src ) . ' -C ' . escapeshellarg( $this->extdir
), $code );
197 $this->error( "failed to extract $src!" );
201 else if ( $ext == '.zip' ) { #zip file
202 $this->note( "extracting $src..." );
203 wfShellExec( 'unzip ' . escapeshellarg( $src ) . ' -d ' . escapeshellarg( $this->extdir
) , $code );
206 $this->error( "failed to extract $src!" );
211 $this->error( "unknown file extension: $ext" );
216 if ( !file_exists( $this->dir
) && glob( $this->dir
. "/*" ) ) {
217 $this->error( "{$this->dir} does not exist or is empty. Something went wrong, sorry." );
221 #TODO: set permissions.... somehow. Copy from extension dir??
223 $this->note( "fetched extension to {$this->dir}" );
227 function patchLocalSettings( $nopatch ) {
228 #NOTE: if we get a better way to hook up extensions, that should be used instead.
230 $f = $this->dir
. '/install.settings';
231 $t = $this->target
. '/LocalSettings.php';
233 #TODO: assert version ?!
234 #TODO: allow custom installer scripts + sql patches
236 if ( !file_exists( $f ) ) {
238 $this->warn( "No install.settings file provided! Please read the instructions and edit LocalSettings.php manually." );
243 $settings = file_get_contents( $f );
246 $this->error( "failed to read settings from $f!" );
250 $settings = str_replace( '{{path}}', $this->incpath
, $settings );
254 $this->note( "Automatic patching is off. Please put the following into your LocalSettings.php:" );
255 print " \n$settings\n";
260 #NOTE: keep php extension for backup file!
261 $bak = $this->target
. '/LocalSettings.install-' . $this->name
. '-' . wfTimestamp(TS_MW
) . '.bak.php';
263 $ok = copy( $t, $bak );
266 $this->warn( "failed to create backup of LocalSettings.php!" );
270 $this->note( "created backup of LocalSettings.php at $bak" );
273 $localsettings = file_get_contents( $t );
276 $this->error( "failed to read $t for patching!" );
280 $marker = "<@< extension {$this->name} >@>";
281 $blockpattern = "/\n\s*#\s*BEGIN\s*$marker.*END\s*$marker\s*/smi";
283 if ( preg_match( $blockpattern, $localsettings ) ) {
284 $localsettings = preg_replace( $blockpattern, "\n", $localsettings );
285 $this->warn( "removed old configuration block for extension {$this->name}!" );
288 $newblock= "\n# BEGIN $marker\n$settings\n# END $marker\n";
290 $localsettings = preg_replace( "/\?>\s*$/si", "$newblock?>", $localsettings );
292 $ok = file_put_contents( $t, $localsettings );
295 $this->error( "failed to patch $t!" );
299 $this->note( "successfully patched LocalSettings.php" );
305 function printNotices( ) {
308 if ( file_exists( $this->dir
. '/README' ) ) $files[] = 'README';
309 if ( file_exists( $this->dir
. '/INSTALL' ) ) $files[] = 'INSTALL';
312 $this->note( "no information files found in {$this->dir}" );
317 $this->note( "Please have a look at the following files in {$this->dir}," );
318 $this->note( "they may contain important information about {$this->name}." );
322 foreach ( $files as $f ) {
323 $this->note ( "\t* $f" );
332 /* static */ function listRepository( $repos ) {
333 preg_match( '!([-\w]+://)?.*?(\.[-\w\d.]+)?$!', $repos, $m );
336 #TODO: right now, this basically lists filenames, so it's not terribly useful.
337 #In future, there should be a "repository + logical name" scheme
339 if ( $proto == 'http://' ) { #HTML directory listing
340 ExtensionInstaller
::note( "listing index from $repos..." );
342 $txt = file_get_contents( $repos );
344 $ok = preg_match_all( '!<a\s[^>]*href\s*=\s*['."'".'"]([^/'."'".'"]+)['."'".'"][^>]*>.*?</a>!si', $txt, $m, PREG_SET_ORDER
);
346 ExtensionInstaller
::error( "listing index from $repos failed!" );
351 foreach ( $m as $l ) {
354 if ( preg_match('!^[./?]!', $n) ) continue;
356 ExtensionInstaller
::note( "\t$n" );
359 else if ( !$proto ) { #local directory
360 ExtensionInstaller
::note( "listing directory $repos..." );
362 $ff = glob( "$repos/*" );
363 if ( $ff === false ||
$ff === NULL ) {
364 ExtensionInstaller
::error( "listing directory $repos failed!" );
368 foreach ( $ff as $f ) {
371 ExtensionInstaller
::note( "\t$n" );
375 ExtensionInstaller
::note( "SVN list $repos..." );
376 $txt = wfShellExec( 'svn ls ' . escapeshellarg( $repos ), $code );
379 ExtensionInstaller
::error( "svn list for $repos failed!" );
383 $ll = preg_split('/(\s*[\r\n]\s*)+/', $txt);
385 foreach ( $ll as $line ) {
386 if ( !preg_match('!^(.*)/$!', $line, $m) ) continue;
388 ExtensionInstaller
::note( "\t{$m[1]}" );
394 if ( isset( $options['list'] ) ) {
395 $repos = $options['list'];
396 if ( $repos === true ||
$repos === 1 ) {
397 # Default to SVN trunk. Perhaps change that to use the version of the present install,
398 # and/or use bundles at an official download location.
399 $repos = 'http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/';
402 ExtensionInstaller
::listRepository( $repos );
407 if( !isset( $args[0] ) ) {
408 die( "USAGE: installExtension.php [options] name [source]\n" .
410 " --target=<dir> mediawiki installation directory\n" .
411 " --nopatch don't touch LocalSettings.php\n" .
413 " May be a local file (tgz or zip) or directory.\n" .
414 " May be the URL of a remote file (tgz or zip).\n" .
415 " May be a SVN repository\n"
421 # Default to SVN trunk. Perhaps change that to use the version of the present install,
422 # and/or use bundles at an official download location.
423 $defsrc = "http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/" . urlencode($name);
425 $src = isset ( $args[1] ) ?
$args[1] : $defsrc;
427 $tgt = isset ( $options['target'] ) ?
$options['target'] : $IP;
429 $nopatch = isset( $options['nopatch'] ) ||
@$wgExtensionInstallerNoPatch;
431 if ( !file_exists( "$tgt/LocalSettings.php" ) ) {
432 die("can't find $tgt/LocalSettings.php\n");
435 if ( !$nopatch && !is_writable( "$tgt/LocalSettings.php" ) ) {
436 die("can't write to $tgt/LocalSettings.php\n");
439 if ( !file_exists( "$tgt/extensions" ) ) {
440 die("can't find $tgt/extensions\n");
443 if ( !is_writable( "$tgt/extensions" ) ) {
444 die("can't write to $tgt/extensions\n");
447 $installer = new ExtensionInstaller( $name, $src, $tgt );
449 $installer->note( "Installing extension {$installer->name} from {$installer->source} to {$installer->dir}" );
452 print "\tTHIS TOOL IS EXPERIMENTAL!\n";
453 print "\tEXPECT THE UNEXPECTED!\n";
456 if ( !$installer->confirm("continue") ) die("aborted\n");
458 $ok = $installer->fetchExtension();
460 if ( $ok ) $ok = $installer->patchLocalSettings( $nopatch );
462 $ok = $installer->printNotices();
464 if ( $ok ) $installer->note( "$name extension was installed successfully" );