チュートリアルに関するチュートリアルPHPとFFMPEGでビデオサムネイルをすばやく生成します

gitbox 2025-06-24

PHPでビデオサムネイルを生成する簡単な方法

プレビュー画像は、Webページやアプリにビデオを表示するときにユーザーエクスペリエンスを大幅に改善できます。この記事では、PHPを介してFFMPEGを呼び出して、ビデオから指定された時間の画像のフレームをサムネイルとして抽出する方法を紹介します。

FFMPEGツールをインストールします

PHPを使用してビデオを処理するには、まず、ほぼすべてのオーディオおよびビデオ形式をサポートするコマンドラインツールであるFFMPEGをインストールする必要があります。

Linuxシステムでは、次のコマンドを介してインストールできます。

 
sudo apt-get install ffmpeg

Windowsユーザーは、FFMPEGの公式Webサイト（ https://ffmpeg.org ）にアクセスして、インストールパッケージをダウンロードし、指示に従ってシステム環境変数を構成できます。

PHPはFFMPEGを呼び出してビデオフレームを抽出します

PHPでシステムコマンドを実行することにより、FFMPEGをプレビュー画像としてビデオの特定のフレームに抽出することができます。この関数を実装するための例コードは次のとおりです。

 
function getVideoThumbnail($videoPath, $thumbnailPath) {
    $ffmpegPath = '/usr/bin/ffmpeg'; // 設定FFmpegパス
    $command = "$ffmpegPath -i $videoPath -ss 00:00:01 -vframes 1 $thumbnailPath";
    exec($command);
}

$videoPath = '/path/to/video.mp4';       // 视频文件パス
$thumbnailPath = '/path/to/thumbnail.jpg'; // 缩略图保存パス
getVideoThumbnail($videoPath, $thumbnailPath);

ここで使用される-SSパラメーターは、フレームを傍受する時間を設定し（1秒）、実際のニーズに応じて値を調整できます。

権限と環境構成に関する予防策

PHPランタイム環境がコマンドライン命令の実行を許可し、一部のホストがデフォルトでexec（）機能を無効にすることを確認してください。あなたはそれが有効になっているかどうかを確認できます：

 
php -m | grep exec

Webページでのビデオのプレビュー

サムネイルが生成された後、通常、Webページに表示する必要があります。以下は、簡素化されたディスプレイプロセスです。

 
<?php
$videoPath = '/path/to/video.mp4';
$thumbnailPath = '/path/to/thumbnail.jpg';
getVideoThumbnail($videoPath, $thumbnailPath);
?>
<h2>ビデオサムネイル</h2>
<p>生成されたサムネイル，パス为：<?php echo $thumbnailPath; ?></p>

HTMLはここで省略されていることに注意してくださいタグ、カスタムスタイルまたはJSを使用して画像表示ロジックを処理することをお勧めします。

結論

FFMPEGと組み合わせたPHPを使用してビデオサムネイルを抽出することは、効率的で実用的なソリューションです。 Webコンテンツを豊かにするだけでなく、ビデオディスプレイのインタラクティブなエクスペリエンスも最適化します。この方法は、シンプルなコードと統合が簡単なほとんどのWebプロジェクトで機能します。

exec