MessageChangeStorage.php

<?php
declare( strict_types = 1 );
 
namespace MediaWiki\Extension\Translate\Synchronization;
 
use Cdb\Reader;
use Cdb\Writer;
use InvalidArgumentException;
use MediaWiki\Extension\Translate\MessageSync\MessageSourceChange;
use MediaWiki\Extension\Translate\Utilities\Utilities;
 
class MessageChangeStorage {
    public const DEFAULT_NAME = 'default';
 
    public static function writeChanges( array $changes, string $file ): void {
        $cache = Writer::open( $file );
        $keys = array_keys( $changes );
        $cache->set( '#keys', Utilities::serialize( $keys ) );
 
        foreach ( $changes as $key => $change ) {
            $value = Utilities::serialize( $change->getAllModifications() );
            $cache->set( $key, $value );
        }
        $cache->close();
    }
 
    public static function isValidCdbName( string $fileName ): bool {
        return (bool)preg_match( '/^[a-z_-]{1,100}$/i', $fileName );
    }
 
    public static function getCdbPath( string $fileName ): string {
        return Utilities::cacheFile( "messagechanges.$fileName.cdb" );
    }
 
    public static function getGroupChanges( string $cdbPath, string $groupId ): MessageSourceChange {
        $reader = self::getCdbReader( $cdbPath );
        if ( $reader === null ) {
            return MessageSourceChange::loadModifications( [] );
        }
 
        $groups = Utilities::deserialize( $reader->get( '#keys' ) );
 
        if ( !in_array( $groupId, $groups, true ) ) {
            throw new InvalidArgumentException( "Group Id - '$groupId' not found in cdb file " .
                "(path: $cdbPath)." );
        }
 
        return MessageSourceChange::loadModifications(
            Utilities::deserialize( $reader->get( $groupId ) )
        );
    }
 
    public static function writeGroupChanges(
        MessageSourceChange $changes,
        string $groupId,
        string $cdbPath
    ): void {
        $reader = self::getCdbReader( $cdbPath );
        if ( $reader === null ) {
            return;
        }
 
        $groups = Utilities::deserialize( $reader->get( '#keys' ) );
 
        $allChanges = [];
        foreach ( $groups as $id ) {
            $allChanges[$id] = MessageSourceChange::loadModifications(
                Utilities::deserialize( $reader->get( $id ) )
            );
        }
        $allChanges[$groupId] = $changes;
 
        self::writeChanges( $allChanges, $cdbPath );
    }
 
    private static function getCdbReader( string $cdbPath ): ?Reader {
        // File not found, probably no changes.
        if ( !file_exists( $cdbPath ) ) {
            return null;
        }
 
        return Reader::open( $cdbPath );
    }
 
    public static function getLastModifiedTime( string $cdbPath ): ?int {
        // File not found
        if ( !file_exists( $cdbPath ) ) {
            return null;
        }
 
        $stat = stat( $cdbPath );
 
        return $stat['mtime'];
    }
 
    public static function isModifiedSince( string $cdbPath, int $unixTimestamp ): bool {
        $lastModifiedTime = self::getLastModifiedTime( $cdbPath );
 
        if ( $lastModifiedTime === null ) {
            throw new InvalidArgumentException( "CDB file not found - $cdbPath" );
        }
 
        return $lastModifiedTime <= $unixTimestamp;
    }
}