Yazılım

Laravel Ekran Görüntüsü API’si: PHP’de Ekran Görüntüsü Yakalama ve PDF Oluşturma

Son güncelleme: 25 Mart 2026 04:54

teknomers

Paylaş

Paylaş

Laravel, 10 milyondan fazla kurulum ile web uygulamaları geliştirmek için mükemmel bir platformdur. Ancak, çoğu Laravel uygulaması bir noktada ekran görüntüsü veya PDF oluşturma ihtiyacı duyar:

• Veri için fatura PDF’leri oluşturma
• Paylaşılan bağlantılar için sosyal önizleme resimleri oluşturma
• Kullanıcı tarafından oluşturulan içeriğin moderasyonu için ekran görüntüleri alma
• Sertifikalar veya rozetler oluşturma
• Düzenli verilere dayalı e-posta üstbilgisi resimleri oluşturma

<p>Mevcut seçenekleriniz sınırlıdır:</p>
<ol>
    <li>Chrome binary'si gerektiren <code>spatie/browsershot</code> kullanmak (paylaşımlı barındırmada sıkıntı)</li>
    <li>Basit PDF'ler için yeterli ancak stil konusunda sınırlı olan <code>barryvdh/laravel-dompdf</code> kullanmak</li>
    <li>Puppeteer ile kendiniz inşa etmek — aşırı ve altyapı yükü oluşturur</li>
</ol>

<p>Daha basit bir yol var: <strong>bir ekran görüntüsü API'si</strong>.</p>

<h2>
    <a name="the-laravel-problem-screenshots-without-infrastructure" href="#the-laravel-problem-screenshots-without-infrastructure"></a>
    Laravel Sorunu: Altyapı Olmadan Ekran Görüntüleri
</h2>

<p>Laravel, web uygulamaları oluşturmada mükemmeldir, ancak HTML'den ekran görüntüsü veya PDF oluşturma işlevi ile gelmez. İşte her yaygın çözümün eksikleri:</p>

<p><strong>Seçenek 1: Browsershot (Chrome Gerekir)</strong><br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>

<?php
use Spatie\Browsershot\Browsershot;

// İlk olarak, sunucunuzda Chrome’un kurulu olması gerekir
// Paylaşımlı barındırmada mı? İzinlerde sıkıntı yaşayabilirsiniz.
// Sunucusuz sistemde mi? Sadece Chrome için 500MB+ yük.

Browsershot::url(‘https://example.com‘)
->screenshot()
->save($pathToImage);
?>

<p><strong>Sorunlar:</strong></p>
<ul>
    <li>Sistem düzeyinde Chrome kurulumu gerektirir</li>
    <li>Paylaşımlı barındırmada çalışmaz (root erişimi yok)</li>
    <li>Sunucusuz sistemde aşırı yük oluşturur</li>
    <li>2021'den beri güncellenmedi</li>
</ul>

<p><strong>Seçenek 2: DomPDF (Sınırlı CSS)</strong><br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>

<?php
use Barryvdh\DomPDF\Facade\Pdf;

$pdf = Pdf::loadView(‘invoice’, [‘data’ => $data]);
return $pdf->download(‘invoice.pdf’);

// Temel PDF’ler için iyi çalışır, ancak:
// – CSS Grid? Hayır
// – Modern flexbox? Sınırlı
// – SVG? Sınırlı
// – Fontlar? Karmaşık
?>

<p><strong>Sorunlar:</strong></p>
<ul>
    <li>Sınırlı CSS desteği</li>
    <li>Modern stil ile ilgili render hataları</li>
    <li>Gerçek bir tarayıcı motoru değil</li>
</ul>

<p><strong>Seçenek 3: PageBolt API (Sıfır Bağımlılık)</strong><br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>

<?php
use Illuminate\Support\Facades\Http;

$response = Http::post(‘https://api.pagebolt.dev/take_screenshot‘, [
‘Authorization’ => ‘Bearer ‘ . env(‘PAGEBOLT_API_KEY’),
], [
‘url’ => ‘https://example.com‘,
‘width’ => 1200,
‘height’ => 630
]);

$imageUrl = $response->json(‘imageUrl’);
// İşte bu kadar. Chrome yok. Altyapı yok.
?>

<p><strong>Avantajlar:</strong></p>
<ul>
    <li>Sıfır sistem bağımlılığı</li>
    <li>Herhangi bir barındırmada çalışır</li>
    <li>Modern Chromium render</li>
    <li>Anında ölçeklenir</li>
</ul>

<h2>
    <a name="build-a-reusable-laravel-service" href="#build-a-reusable-laravel-service"></a>
    Yeniden Kullanılabilir Bir Laravel Servisi Oluşturma
</h2>

<p>PageBolt API çağrılarını sarmak için bir servis sınıfı oluşturun:</p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>

<?php
namespace App\Services;

use Illuminate\Support\Facades\Http;

class PageBoltService
{
protected $apiKey;
protected $baseUrl = ‘https://api.pagebolt.dev‘;

public function __construct()
{
    $this->apiKey = config('services.pagebolt.key');
}

/ 
 * Bir URL'nin ekran görüntüsünü al
 */
public function screenshot(string $url, array $options = []): ?string
{
    $payload = array_merge(['url' => $url], $options);

    $response = Http::withHeaders([
        'Authorization' => "Bearer {$this->apiKey}",
        'Content-Type' => 'application/json'
    ])->post("{$this->baseUrl}/take_screenshot", $payload);

    if ($response->failed()) {
        return null;
    }

    return $response->json('imageUrl');
}

/ 
 * Bir URL'den PDF oluştur
 */
public function pdfFromUrl(string $url, array $options = []): ?string
{
    $payload = array_merge(['url' => $url], $options);

    $response = Http::withHeaders([
        'Authorization' => "Bearer {$this->apiKey}",
        'Content-Type' => 'application/json'
    ])->post("{$this->baseUrl}/generate_pdf", $payload);

    if ($response->failed()) {
        return null;
    }

    return $response->json('pdfUrl');
}

/ 
 * Ham HTML'den PDF oluştur
 */
public function pdfFromHtml(string $html, array $options = []): ?string
{
    $payload = array_merge(['html' => $html], $options);

    $response = Http::withHeaders([
        'Authorization' => "Bearer {$this->apiKey}",
        'Content-Type' => 'application/json'
    ])->post("{$this->baseUrl}/generate_pdf", $payload);

    if ($response->failed()) {
        return null;
    }

    return $response->json('pdfUrl');
}

/ 
 * Ham HTML'den ekran görüntüsü al
 */
public function screenshotFromHtml(string $html, array $options = []): ?string
{
    $payload = array_merge(['html' => $html], $options);

    $response = Http::withHeaders([
        'Authorization' => "Bearer {$this->apiKey}",
        'Content-Type' => 'application/json'
    ])->post("{$this->baseUrl}/take_screenshot", $payload);

    if ($response->failed()) {
        return null;
    }

    return $response->json('imageUrl');
}

}
?>

<h2>
    <a name="realworld-laravel-examples" href="#realworld-laravel-examples"></a>
    Gerçek Dünya Laravel Örnekleri
</h2>

<h3>
    <a name="example-1-generate-invoice-pdfs" href="#example-1-generate-invoice-pdfs"></a>
    Örnek 1: Fatura PDF'leri Oluşturma
</h3>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>

<?php
namespace App\Http\Controllers;

use App\Models\Invoice;
use App\Services\PageBoltService;

class InvoiceController extends Controller
{
public function __construct(protected PageBoltService $pagebolt) {}

public function pdf(Invoice $invoice)
{
    // Fatura görünümünü HTML olarak render et
    $html = view('invoices.template', ['invoice' => $invoice])->render();

    // PDF'ye dönüştür
    $pdfUrl = $this->pagebolt->pdfFromHtml($html, [
        'format' => 'A4',
        'margin' => '10mm'
    ]);

    if (!$pdfUrl) {
        return response()->json(['error' => 'PDF oluşturma başarısız oldu'], 500);
    }

    // PDF'yi indir
    return redirect($pdfUrl);
}

}
?>

<h3>
    <a name="example-2-create-social-preview-images" href="#example-2-create-social-preview-images"></a>
    Örnek 2: Sosyal Önizleme Resimleri Oluşturma
</h3>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>

<?php
namespace App\Http\Controllers;

use App\Models\BlogPost;
use App\Services\PageBoltService;

class BlogController extends Controller
{
public function __construct(protected PageBoltService $pagebolt) {}

public function generateOGImage(BlogPost $post)
{
    $html = view('og-template', [
        'title' => $post->title,
        'author' => $post->author->name,
        'date' => $post->created_at->format('M d, Y')
    ])->render();

    $imageUrl = $this->pagebolt->screenshotFromHtml($html, [
        'width' => 1200,
        'height' => 630
    ]);

    // URL'yi veritabanınıza veya önbelleğinize kaydedin
    $post->update(['og_image_url' => $imageUrl]);

    return response()->json(['image_url' => $imageUrl]);
}

}
?>

<h3>
    <a name="example-3-screenshot-content-for-moderation" href="#example-3-screenshot-content-for-moderation"></a>
    Örnek 3: Moderasyon İçin İçerik Ekran Görüntüsü Alma
</h3>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>

<?php
namespace App\Jobs;

use App\Models\UserContent;
use App\Services\PageBoltService;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;

class CaptureContentScreenshot implements ShouldQueue
{
use Queueable;

public function __construct(protected UserContent $content) {}

public function handle(PageBoltService $pagebolt)
{
    // Kullanıcı tarafından oluşturulan içeriğin ekran görüntüsünü alın
    $screenshot = $pagebolt->screenshot($this->content->url, [
        'width' => 1280,
        'height' => 720
    ]);

    if ($screenshot) {
        $this->content->update(['screenshot_url' => $screenshot]);
    }
}

}
?>

<h2>
    <a name="configuration-setup" href="#configuration-setup"></a>
    Yapılandırma Ayarları
</h2>

<p><code>.env</code> dosyanıza ekleyin:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>

PAGEBOLT_API_KEY=your_api_key_here

<p><code>config/services.php</code> dosyanıza ekleyin:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>

<?php
return [
‘pagebolt’ => [
‘key’ => env(‘PAGEBOLT_API_KEY’),
],
];
?>

<p>Servisi <code>AppServiceProvider</code>'da kaydedin:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>

<?php
namespace App\Providers;

use App\Services\PageBoltService;
use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider
{
public function register()
{
$this->app->singleton(PageBoltService::class, function ($app) {
return new PageBoltService();
});
}
}
?>

<h2>
    <a name="why-pagebolt-for-laravel" href="#why-pagebolt-for-laravel"></a>
    Neden Laravel için PageBolt
</h2>

<div class="table-wrapper-paragraph">
    <table>
        <thead>
            <tr>
                <th>Özellik</th>
                <th>Browsershot</th>
                <th>DomPDF</th>
                <th><strong>PageBolt API</strong></th>
            </tr>
        </thead>
        <tbody>
            <tr>
                <td><strong>Kurulum</strong></td>
                <td>Chrome binary'sini yükleyin</td>
                <td>Composer bağımlılığı</td>
                <td>API anahtarı</td>
            </tr>
            <tr>
                <td><strong>Paylaşımlı barındırmada çalışır</strong></td>
                <td>❌ Hayır</td>
                <td>✅ Evet</td>
                <td>✅ Evet</td>
            </tr>
            <tr>
                <td><strong>Sunucusuz sistemde çalışır</strong></td>
                <td>⚠️ Ağır yük</td>
                <td>✅ Evet</td>
                <td>✅ Evet</td>
            </tr>
            <tr>
                <td><strong>CSS Desteği</strong></td>
                <td>✅ Tam modern CSS</td>
                <td>⚠️ Sınırlı</td>
                <td>✅ Tam modern CSS</td>
            </tr>
            <tr>
                <td><strong>SVG/fontlar</strong></td>
                <td>✅ Tam destek</td>
                <td>⚠️ Sınırlı</td>
                <td>✅ Tam destek</td>
            </tr>
            <tr>
                <td><strong>Bağımlılıklar</strong></td>
                <td>Chrome binary'si</td>
                <td>Yalnızca PHP</td>
                <td>Yok (HTTP)</td>
            </tr>
            <tr>
                <td><strong>Bakım</strong></td>
                <td>🚨 Terk edildi (2021)</td>
                <td>⚠️ Topluluk</td>
                <td>✅ Aktif</td>
            </tr>
            <tr>
                <td><strong>İlk PDF için süre</strong></td>
                <td>Saatler (kurulum)</td>
                <td>Dakikalar</td>
                <td>Dakikalar</td>
            </tr>
        </tbody>
    </table>
</div>

<h2>
    <a name="getting-started" href="#getting-started"></a>
    Başlarken
</h2>

<p><strong>1. Bir API anahtarı alın</strong> (ücretsiz katman: 100 istekte bulunma/bay)</p>

<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>

pagebolt.dev adresini ziyaret edin, hesap oluşturun, API anahtarını kopyalayın.

    </code></pre>
</div>

<p><strong>2. Servis sınıfını oluşturun</strong> (yukarıdaki kod)</p>

<p><strong>3. Kontrolörlerinizde kullanın</strong><br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>

<?php
// Enjekte edin ve kullanın
public function __construct(PageBoltService $pagebolt)
{
$this->pagebolt = $pagebolt;
}

// Ekran görüntüsü alın
$imageUrl = $this->pagebolt->screenshot(‘https://example.com‘);

// PDF oluşturun
$pdfUrl = $this->pagebolt->pdfFromHtml($htmlString);
?>