AutoLoader.php

Go to the documentation of this file.

<?php
// NO_AUTOLOAD -- file scope code, can't load self
 
require_once __DIR__ . '/../autoload.php';
 
class AutoLoader {
 
    private static $psr4Namespaces = [];
 
    private static $classFiles = [];
 
    public static function registerNamespaces( array $dirs ): void {
        self::$psr4Namespaces += $dirs;
    }
 
    public static function registerClasses( array $files ): void {
        self::$classFiles += $files;
    }
 
    public static function loadFile( string $file ): void {
        require_once $file;
    }
 
    public static function loadFiles( array $files ): void {
        foreach ( $files as $f ) {
            self::loadFile( $f );
        }
    }
 
    public static function find( $className ): ?string {
        global $wgAutoloadLocalClasses, $wgAutoloadClasses;
 
        // NOTE: $wgAutoloadClasses is supported for compatibility with old-style extension
        //       registration files.
 
        $filename = $wgAutoloadLocalClasses[$className] ??
            self::$classFiles[$className] ??
            $wgAutoloadClasses[$className] ??
            false;
 
        if ( !$filename && str_contains( $className, '\\' ) ) {
            // This class is namespaced, so look in the namespace map
            $prefix = $className;
            // phpcs:ignore Generic.CodeAnalysis.AssignmentInCondition.FoundInWhileCondition
            while ( ( $pos = strrpos( $prefix, '\\' ) ) !== false ) {
                // Check to see if this namespace prefix is in the map
                $prefix = substr( $className, 0, $pos + 1 );
                if ( isset( self::$psr4Namespaces[$prefix] ) ) {
                    $relativeClass = substr( $className, $pos + 1 );
                    // Build the expected filename, and see if it exists
                    $file = self::$psr4Namespaces[$prefix] .
                        strtr( $relativeClass, '\\', '/' ) .
                        '.php';
                    if ( is_file( $file ) ) {
                        $filename = $file;
                        break;
                    }
                }
 
                // Remove trailing separator for next iteration
                $prefix = rtrim( $prefix, '\\' );
            }
        }
 
        if ( !$filename ) {
            // Class not found; let the next autoloader try to find it
            return null;
        }
 
        // Make an absolute path, this improves performance by avoiding some stat calls
        // Optimisation: use string offset access instead of substr
        if ( $filename[0] !== '/' && $filename[1] !== ':' ) {
            $filename = __DIR__ . '/../' . $filename;
        }
 
        return $filename;
    }
 
    public static function autoload( $className ) {
        $filename = self::find( $className );
 
        if ( $filename !== null ) {
            require_once $filename;
        }
    }
 
    private static function assertTesting( string $method ): void {
        if ( !defined( 'MW_PHPUNIT_TEST' ) ) {
            throw new LogicException( "$method is not supported outside phpunit tests!" );
        }
    }
 
    public static function getClassFiles(): array {
        global $wgAutoloadLocalClasses, $wgAutoloadClasses;
 
        self::assertTesting( __METHOD__ );
 
        // NOTE: ensure the order of preference is the same as used by find().
        return array_merge(
            $wgAutoloadClasses,
            self::$classFiles,
            $wgAutoloadLocalClasses
        );
    }
 
    public static function getNamespaceDirectories(): array {
        self::assertTesting( __METHOD__ );
        return self::$psr4Namespaces;
    }
 
    public static function getState(): array {
        self::assertTesting( __METHOD__ );
        return [
            'classFiles' => self::$classFiles,
            'psr4Namespaces' => self::$psr4Namespaces,
        ];
    }
 
    public static function restoreState( $state ): void {
        self::assertTesting( __METHOD__ );
 
        self::$classFiles = $state['classFiles'];
        self::$psr4Namespaces = $state['psr4Namespaces'];
    }
 
}
 
spl_autoload_register( AutoLoader::autoload( ... ) );
 
// Load composer's autoloader if present
if ( is_readable( __DIR__ . '/../vendor/autoload.php' ) ) {
    require_once __DIR__ . '/../vendor/autoload.php';
} elseif ( file_exists( __DIR__ . '/../vendor/autoload.php' ) ) {
    die( __DIR__ . '/../vendor/autoload.php exists but is not readable' );
}