path()); return is_string($sha) && self::isSha(trim($sha)) ? strtolower(trim($sha)) : null; } public function save(string $sha): void { if (! self::isSha($sha)) { throw new InvalidArgumentException('Ungültiger Commit-Stand: erwartet werden 40 Hex-Zeichen.'); } AtomicFile::write($this->path(), strtolower($sha)); } public function short(): ?string { return ($sha = $this->current()) ? substr($sha, 0, 7) : null; } public function release(): string { return Version::VERSION; } /** * „1.4.2 (a1b2c3d)“ bzw. nur „1.4.2“, solange kein Stand bekannt ist. */ public function full(): string { return $this->release().(($short = $this->short()) ? " ({$short})" : ''); } public static function isSha(string $value): bool { return (bool) preg_match('/^[0-9a-f]{40}$/i', $value); } private function path(): string { return $this->file ?? storage_path('.version'); } }