browsershot

ヘッドレス Chrome を使用して Web ページを画像または PDF に変換する

このパッケージは、Web ページを画像または PDF に変換できます。変換は、Google Chrome のヘッドレス バージョンを制御する Puppeteer によってバックグラウンドで行われます。

簡単な例を次に示します。

 use SpatieBrowsershotBrowsershot;// 画像が保存されますBrowsershot::url('https://example.com')->save($pathToImage);

saveメソッドに渡されたパスにpdf拡張子が付いている場合、pdf が保存されます。

 // PDF が保存されますBrowsershot::url('https://example.com')->save('example.pdf');

任意の HTML 入力を使用することもできます。単にurlメソッドをhtmlに置き換えます。

 Browsershot::html('<h1>Hello world!!</h1>')->save('example.pdf');

HTML 入力が既にローカルのファイルにある場合は、次を使用します。

 Browsershot::htmlFromFilePath('/local/path/to/file.html')->save('example.pdf');

Browsershot は、JavaScript の実行後に HTML ページの本文を取得することもできます。

 Browsershot::url('https://example.com')->bodyHtml(); // 本文のHTMLを返す

ページがトリガーしたすべてのリクエストを含む配列リストを取得したい場合は、次のように実行できます。

 $requests = Browsershot::url('https://example.com')
    ->triggeredRequests();foreach ($request としての $request) {$url = $request['url']; //https://example.com/}

Chrome の新しいヘッドレス モードを使用するには、 newHeadlessメソッドを渡します。

 Browsershot::url('https://example.com')->newHeadless()->save($pathToImage);

サポートしてください

このようなパッケージの作成方法については、プレミアム ビデオ コースをご覧ください。

私たちはクラス最高のオープンソース パッケージの作成に多くのリソースを投資しています。有料製品のいずれかを購入することで、私たちをサポートできます。

当社のどのパッケージを使用しているかについて、故郷から葉書を送っていただき、誠にありがとうございます。当社の住所は、お問い合わせページに記載されています。受け取ったすべてのポストカードをバーチャル ポストカード ウォールに公開します。

ドキュメント

すべてのドキュメントはドキュメント サイトから入手できます。

テスト

テストスイートを実行するには、Puppeteer をインストールする必要があります。ここでブラウザショットの要件を参照してください。通常は、 npm -gi puppeteer機能します。

さらに、poppler-utils パッケージの一部であるpdftotext CLI が必要になります。詳細については、spatie/pdf-to-text readme を参照してください。通常は、 brew install poppler-utils十分です。

最後に以下を使用してテストを実行します。

作曲家テスト

貢献する

詳細については、「貢献」を参照してください。

安全

セキュリティに関するバグを見つけた場合は、問題トラッカーを使用する代わりに [email protected] にメールを送信してください。

代替案

Node と Puppeteer をインストールできない場合は、Chrome ヘッドレス CLI を使用してスクリーンショットを撮る、browsershot の v2 を確認してください。 v2もうメンテナンスされていませんが、かなりうまく動作するはずです。

ヘッドレス Chrome の使用が機能しない場合は、放棄されたPhantomJSバイナリを使用するこのパッケージのv1を確認してください。

クレジット

• フリーク・ファン・デル・ヘルテン

• すべての貢献者

そしてロゴを提供してくれたCanecoに特別な感謝を捧げます

ライセンス

MIT ライセンス (MIT)。詳細については、ライセンス ファイルを参照してください。