| Server IP : 167.235.224.122 / Your IP : 216.73.216.110 Web Server : Apache/2.4.58 (Ubuntu) System : Linux newplayground 6.8.0-136-generic #136-Ubuntu SMP PREEMPT_DYNAMIC Wed Jul 1 21:33:11 UTC 2026 aarch64 User : deploy ( 1000) PHP Version : 8.4.23 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : OFF Directory : /var/www/html/europiastories/app/Services/ |
Upload File : |
<?php
namespace App\Services;
use App\Models\Edition;
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str;
/**
* Resolves and stores cover images for editions with an ISBN.
*
* Provider chain (pattern from otherland's BookService):
* 1. ISBNdb (paid API, key in ISBNDB_API_KEY) — best metadata quality
* 2. Open Library covers (free, no key) — good for classics, thin for
* small-language European titles
* If nothing resolves, the edition keeps cover_path = null and views render
* the typographic Nebula placeholder — no fake covers, ever.
*/
class CoverService
{
/**
* Try to resolve and store a cover; returns the provider used or null.
*/
public function resolve(Edition $edition): ?string
{
if (! $edition->isbn || $edition->cover_path) {
return null;
}
foreach (['isbndb' => $this->fromIsbndb(...), 'openlibrary' => $this->fromOpenLibrary(...)] as $provider => $fetch) {
$url = $fetch($edition->isbn);
if ($url && $this->store($edition, $url, $provider)) {
return $provider;
}
}
return null;
}
private function fromIsbndb(string $isbn): ?string
{
$key = config('services.isbndb.key');
if (! $key) {
return null;
}
$response = Http::withHeaders(['Authorization' => $key])
->get(rtrim(config('services.isbndb.base_url'), '/') . '/book/' . $this->normalize($isbn));
return $response->ok() ? $response->json('book.image') : null;
}
private function fromOpenLibrary(string $isbn): ?string
{
$url = 'https://covers.openlibrary.org/b/isbn/' . $this->normalize($isbn) . '-L.jpg?default=false';
return Http::head($url)->ok() ? $url : null;
}
private function store(Edition $edition, string $imageUrl, string $provider): bool
{
$response = Http::timeout(20)->get($imageUrl);
if (! $response->ok() || $response->body() === '') {
return false;
}
$ext = pathinfo(parse_url($imageUrl, PHP_URL_PATH) ?? '', PATHINFO_EXTENSION) ?: 'jpg';
$path = 'covers/' . Str::uuid() . '.' . $ext;
// Shared StorageBox, not the local disk: dev and production share the
// DB, so they must share the files the DB points at.
Storage::disk('hetzner_sftp')->put($path, $response->body());
// Predictively warm this host's serve cache (CoverController) — the
// host that fetched a cover is usually the one about to serve it.
Storage::disk('local')->put('cover-cache/' . basename($path), $response->body());
$edition->forceFill([
'cover_path' => $path,
'cover_source' => $provider,
'cover_external_url' => $imageUrl,
]);
if ($edition->exists) {
$edition->save();
}
return true;
}
private function normalize(string $isbn): string
{
return preg_replace('/[^0-9Xx]/', '', $isbn);
}
}