<?php
/**
 * Zeitbudget eines Laufs.
 *
 * @package Aivor\Content
 */

namespace Aivor\Content\Import;

defined( 'ABSPATH' ) || exit;

/**
 * Haelt einen Lauf unter der max_execution_time des Hosts.
 *
 * Shared Hosting steht oft bei 30 Sekunden. Ein Lauf, der mitten im
 * Schreiben abgebrochen wird, ist schlimmer als einer, der frueh aufhoert
 * und den Rest der naechsten Stunde ueberlaesst.
 */
final class TimeBudget {

	/**
	 * Obergrenze in Sekunden, auch wenn der Host mehr erlaubt.
	 *
	 * @var int
	 */
	private const MAX_SECONDS = 40;

	/**
	 * Reserve bis zur Grenze des Hosts.
	 *
	 * @var int
	 */
	private const SAFETY_SECONDS = 10;

	/**
	 * Startzeitpunkt.
	 *
	 * @var float
	 */
	private float $started;

	/**
	 * Verfuegbare Sekunden.
	 *
	 * @var float
	 */
	private float $seconds;

	/**
	 * Startet das Budget.
	 *
	 * @param float|null $seconds Feste Laenge, sonst aus max_execution_time abgeleitet.
	 */
	public function __construct( ?float $seconds = null ) {
		$this->started = microtime( true );
		$this->seconds = $seconds ?? self::derive_seconds();
	}

	/**
	 * Ob das Budget aufgebraucht ist.
	 *
	 * @return bool
	 */
	public function exhausted(): bool {
		return $this->remaining() <= 0;
	}

	/**
	 * Verbleibende Sekunden.
	 *
	 * @return float
	 */
	public function remaining(): float {
		return $this->seconds - ( microtime( true ) - $this->started );
	}

	/**
	 * Die Laenge des Budgets fuer diesen Host.
	 *
	 * @return float
	 */
	private static function derive_seconds(): float {
		$limit = (int) ini_get( 'max_execution_time' );

		if ( $limit <= 0 ) {
			return self::MAX_SECONDS;
		}

		return (float) max( 5, min( self::MAX_SECONDS, $limit - self::SAFETY_SECONDS ) );
	}
}