manageForeignResources.php

Go to the documentation of this file.

<?php
require_once __DIR__ . '/Maintenance.php';
 
class ManageForeignResources extends Maintenance {
    public function __construct() {
        parent::__construct();
        $this->addDescription( <<<TEXT
Manage foreign resources registered with ResourceLoader.
 
This helps developers with downloading, verifying, and updating local copies of upstream
libraries registered as ResourceLoader modules. See resources/lib/foreign-resources.yaml.
 
Use the "update" action to download urls specified in foreign-resources.yaml, and unpack
them to the resources directory. This will also verify them against the integrity hashes.
 
Use the "verify" action to verify the files currently in the resources directory match
what "update" would replace them with. This is effectively a dry-run and will not change
any module resources on disk.
 
Use the "make-sri" action to compute an integrity hash for upstreams that do not publish
one themselves. Add or update the urls foreign-resources.yaml as needed, but omit (or
leave empty) the "integrity" key. Then, run the "make-sri" action for the module and
copy the integrity into the file. Then, you can use "verify" or "update" normally.
TEXT
        );
        $this->addArg( 'action', 'One of "update", "verify" or "make-sri"', true );
        $this->addArg( 'module', 'Name of a single module (Default: all)', false );
        $this->addOption( 'verbose', 'Be verbose', false, false, 'v' );
    }
 
    public function execute() {
        global $IP;
        $frm = new ForeignResourceManager(
            "{$IP}/resources/lib/foreign-resources.yaml",
            "{$IP}/resources/lib",
            function ( $text ) {
                $this->output( $text );
            },
            function ( $text ) {
                $this->error( $text );
            },
            function ( $text ) {
                if ( $this->hasOption( 'verbose' ) ) {
                    $this->output( $text );
                }
            }
        );
 
        $action = $this->getArg( 0 );
        $module = $this->getArg( 1, 'all' );
 
        try {
            return $frm->run( $action, $module );
        } catch ( Exception $e ) {
            $this->fatalError( "Error: {$e->getMessage()}" );
        }
    }
}
 
$maintClass = ManageForeignResources::class;
require_once RUN_MAINTENANCE_IF_MAIN;