mergeMessageFileList.php

Go to the documentation of this file.

<?php
# Start from scratch
define( 'MW_NO_EXTENSION_MESSAGES', 1 );

require_once __DIR__ . '/Maintenance.php';
$maintClass = 'MergeMessageFileList';
$mmfl = false;

class MergeMessageFileList extends Maintenance {
    protected $hasError;

    function __construct() {
        parent::__construct();
        $this->addOption(
            'list-file',
            'A file containing a list of extension setup files, one per line.',
            false,
            true
        );
        $this->addOption( 'extensions-dir', 'Path where extensions can be found.', false, true );
        $this->addOption( 'output', 'Send output to this file (omit for stdout)', false, true );
        $this->addDescription( 'Merge $wgExtensionMessagesFiles and $wgMessagesDirs from ' .
            ' various extensions to produce a single file listing all message files and dirs.'
        );
    }

    public function execute() {
        // @codingStandardsIgnoreStart Ignore error: Global variable "$mmfl" is lacking 'wg' prefix
        global $mmfl;
        // @codingStandardsIgnoreEnd
        global $wgExtensionEntryPointListFiles;

        if ( !count( $wgExtensionEntryPointListFiles )
            && !$this->hasOption( 'list-file' )
            && !$this->hasOption( 'extensions-dir' )
        ) {
            $this->error( "Either --list-file or --extensions-dir must be provided if " .
                "\$wgExtensionEntryPointListFiles is not set", 1 );
        }

        $mmfl = [ 'setupFiles' => [] ];

        # Add setup files contained in file passed to --list-file
        if ( $this->hasOption( 'list-file' ) ) {
            $extensionPaths = $this->readFile( $this->getOption( 'list-file' ) );
            $mmfl['setupFiles'] = array_merge( $mmfl['setupFiles'], $extensionPaths );
        }

        # Now find out files in a directory
        if ( $this->hasOption( 'extensions-dir' ) ) {
            $extdir = $this->getOption( 'extensions-dir' );
            # Allow multiple directories to be passed with ":" as delimiter
            $extdirs = explode( ':', $extdir );
            $entries = [];
            foreach ( $extdirs as $extdir ) {
                $entries = array_merge( $entries, scandir( $extdir ) );
            }
            foreach ( $entries as $extname ) {
                if ( $extname == '.' || $extname == '..' || !is_dir( "$extdir/$extname" ) ) {
                    continue;
                }
                $possibilities = [
                    "$extdir/$extname/extension.json",
                    "$extdir/$extname/skin.json",
                    "$extdir/$extname/$extname.php"
                ];
                $found = false;
                foreach ( $possibilities as $extfile ) {
                    if ( file_exists( $extfile ) ) {
                        $mmfl['setupFiles'][] = $extfile;
                        $found = true;
                        break;
                    }
                }

                if ( !$found ) {
                    $this->hasError = true;
                    $this->error( "Extension {$extname} in {$extdir} lacks expected entry point: " .
                        "extension.json, skin.json, or {$extname}.php." );
                }
            }
        }

        # Add setup files defined via configuration
        foreach ( $wgExtensionEntryPointListFiles as $points ) {
            $extensionPaths = $this->readFile( $points );
            $mmfl['setupFiles'] = array_merge( $mmfl['setupFiles'], $extensionPaths );
        }

        if ( $this->hasError ) {
            $this->error( "Some files are missing (see above). Giving up.", 1 );
        }

        if ( $this->hasOption( 'output' ) ) {
            $mmfl['output'] = $this->getOption( 'output' );
        }
        if ( $this->hasOption( 'quiet' ) ) {
            $mmfl['quiet'] = true;
        }
    }

    private function readFile( $fileName ) {
        global $IP;

        $files = [];
        $fileLines = file( $fileName );
        if ( $fileLines === false ) {
            $this->hasError = true;
            $this->error( "Unable to open list file $fileName." );

            return $files;
        }
        # Strip comments, discard empty lines, and trim leading and trailing
        # whitespace. Comments start with '#' and extend to the end of the line.
        foreach ( $fileLines as $extension ) {
            $extension = trim( preg_replace( '/#.*/', '', $extension ) );
            if ( $extension !== '' ) {
                # Paths may use the string $IP to be substituted by the actual value
                $extension = str_replace( '$IP', $IP, $extension );
                if ( file_exists( $extension ) ) {
                    $files[] = $extension;
                } else {
                    $this->hasError = true;
                    $this->error( "Extension {$extension} doesn't exist" );
                }
            }
        }

        return $files;
    }
}

require_once RUN_MAINTENANCE_IF_MAIN;

$queue = [];
foreach ( $mmfl['setupFiles'] as $fileName ) {
    if ( strval( $fileName ) === '' ) {
        continue;
    }
    if ( empty( $mmfl['quiet'] ) ) {
        fwrite( STDERR, "Loading data from $fileName\n" );
    }
    // Using extension.json or skin.json
    if ( substr( $fileName, -strlen( '.json' ) ) === '.json' ) {
        $queue[$fileName] = 1;
    } else {
        require_once $fileName;
    }
}

if ( $queue ) {
    $registry = new ExtensionRegistry();
    $data = $registry->readFromQueue( $queue );
    foreach ( [ 'wgExtensionMessagesFiles', 'wgMessagesDirs' ] as $var ) {
        if ( isset( $data['globals'][$var] ) ) {
            $GLOBALS[$var] = array_merge( $data['globals'][$var], $GLOBALS[$var] );
        }
    }
}

fwrite( STDERR, "\n" );
$s =
    "<" . "?php\n" .
    "## This file is generated by mergeMessageFileList.php. Do not edit it directly.\n\n" .
    "if ( defined( 'MW_NO_EXTENSION_MESSAGES' ) ) return;\n\n" .
    '$wgExtensionMessagesFiles = ' . var_export( $wgExtensionMessagesFiles, true ) . ";\n\n" .
    '$wgMessagesDirs = ' . var_export( $wgMessagesDirs, true ) . ";\n\n";

$dirs = [
    $IP,
    dirname( __DIR__ ),
    realpath( $IP )
];

foreach ( $dirs as $dir ) {
    $s = preg_replace( "/'" . preg_quote( $dir, '/' ) . "([^']*)'/", '"$IP\1"', $s );
}

if ( isset( $mmfl['output'] ) ) {
    file_put_contents( $mmfl['output'], $s );
} else {
    echo $s;
}