在 symfony 项目中,要将视频元数据转换为数组,1. 需通过 composer 安装 php-ffmpeg 库(composer require php-ffmpeg/php-ffmpeg);2. 创建服务类 videometadataextractor 并注入 ffprobe 实例;3. 使用 ffprobe::create() 初始化探针并调用 probe() 方法解析视频文件;4. 通过 getformat() 和 getstreams() 获取格式与音视频流信息;5. 将各项元数据如时长、分辨率、编码格式等提取为关联数组返回;该方法能将原始媒体信息结构化,便于在应用中用于展示、存储、处理决策或故障排查,结合异步任务、缓存和错误处理机制可提升系统性能与稳定性。

在 Symfony 项目中,要将视频的元数据转换为数组,通常我们不会直接依赖 Symfony 框架本身,因为 Symfony 更多是Web应用骨架。这项任务的核心在于利用外部的PHP库来与底层的多媒体处理工具(如FFmpeg和FFprobe)进行交互。最常见的做法是使用像
PHP-FFMpeg
将视频元数据转换为数组,最直接且推荐的方式是利用
PHP-FFMpeg
ffprobe
首先,你需要通过 Composer 安装这个库:
composer require php-ffmpeg/php-ffmpeg
然后,在你的 Symfony 服务或控制器中,你可以这样操作来提取并处理视频元数据:
<?php
namespace App\Service;
use FFMpeg\FFMpeg;
use FFMpeg\FFProbe;
use FFMpeg\Exception\FFMpegException;
class VideoMetadataExtractor
{
private FFMpeg $ffmpeg;
private FFProbe $ffprobe;
public function __construct(string $ffmpegBinaryPath = '/usr/bin/ffmpeg', string $ffprobeBinaryPath = '/usr/bin/ffprobe')
{
// 确保你的系统上安装了 ffmpeg 和 ffprobe,并配置好路径
// 或者让库自动查找,但这在生产环境可能不够稳定
$this->ffmpeg = FFMpeg::create([
'ffmpeg.binaries' => $ffmpegBinaryPath,
'ffprobe.binaries' => $ffprobeBinaryPath,
'timeout' => 3600, // 1 hour
'ffmpeg.threads' => 12, // Optional: Number of threads
]);
$this->ffprobe = FFProbe::create([
'ffmpeg.binaries' => $ffmpegBinaryPath, // ffprobe 共享 ffmpeg 的二进制路径
'ffprobe.binaries' => $ffprobeBinaryPath,
'timeout' => 3600,
]);
}
/**
* 提取视频文件的关键元数据并以数组形式返回。
*
* @param string $videoPath 视频文件的完整路径
* @return array 包含视频元数据的关联数组
*/
public function extractMetadataToArray(string $videoPath): array
{
$metadata = [];
try {
// 使用 FFProbe 获取更详细的元数据
$probe = $this->ffprobe->probe($videoPath);
// 获取格式信息
$format = $probe->getFormat();
$metadata['format'] = [
'filename' => $format->get('filename'),
'nb_streams' => $format->get('nb_streams'),
'format_name' => $format->get('format_name'),
'duration' => $format->get('duration'), // 秒
'size' => $format->get('size'), // 字节
'bit_rate' => $format->get('bit_rate'), // 比特率
];
// 获取视频流信息
$videoStream = $probe->getStreams()->videos()->first();
if ($videoStream) {
$metadata['video_stream'] = [
'codec_name' => $videoStream->get('codec_name'),
'width' => $videoStream->get('width'),
'height' => $videoStream->get('height'),
'avg_frame_rate' => $videoStream->get('avg_frame_rate'),
'display_aspect_ratio' => $videoStream->get('display_aspect_ratio'),
'bit_rate' => $videoStream->get('bit_rate'),
'duration' => $videoStream->get('duration'),
'tags' => $videoStream->get('tags'), // 比如旋转信息等
];
}
// 获取音频流信息
$audioStream = $probe->getStreams()->audios()->first();
if ($audioStream) {
$metadata['audio_stream'] = [
'codec_name' => $audioStream->get('codec_name'),
'sample_rate' => $audioStream->get('sample_rate'),
'channels' => $audioStream->get('channels'),
'bit_rate' => $audioStream->get('bit_rate'),
'duration' => $audioStream->get('duration'),
'tags' => $audioStream->get('tags'),
];
}
// 如果你需要FFMpeg对象来处理视频(例如获取缩略图),可以这样:
// $video = $this->ffmpeg->open($videoPath);
// $dimensions = $video->getStreams()->videos()->first()->getDimensions();
// $metadata['dimensions_from_ffmpeg_obj'] = ['width' => $dimensions->getWidth(), 'height' => $dimensions->getHeight()];
} catch (FFMpegException $e) {
// 处理 FFmpeg 或 FFProbe 相关的错误,比如文件不存在、损坏或权限问题
error_log("Failed to extract video metadata for {$videoPath}: " . $e->getMessage());
return ['error' => $e->getMessage()];
} catch (\Exception $e) {
// 捕获其他可能的异常
error_log("An unexpected error occurred during metadata extraction for {$videoPath}: " . $e->getMessage());
return ['error' => $e->getMessage()];
}
return $metadata;
}
}使用时,你可以在你的控制器或服务中注入
VideoMetadataExtractor
extractMetadataToArray
// 假设你在一个 Symfony Controller 中
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;
use App\Service\VideoMetadataExtractor;
class VideoController extends AbstractController
{
#[Route('/video/metadata/{filename}', name: 'app_video_metadata')]
public function showMetadata(string $filename, VideoMetadataExtractor $extractor): Response
{
$videoPath = $this->getParameter('kernel.project_dir') . '/public/videos/' . $filename;
if (!file_exists($videoPath)) {
return new Response('Video not found', Response::HTTP_NOT_FOUND);
}
$metadata = $extractor->extractMetadataToArray($videoPath);
return $this->json($metadata);
}
}这个方案的关键在于
ffprobe
FFMpeg
ffprobe
将视频元数据转换为数组,这其实是数据处理中非常普遍的需求,尤其是当你的应用需要与这些数据进行交互时。想象一下,如果
ffprobe
它的用处非常广泛:
本质上,它把原始、低层次的媒体信息,转换成了高层次、易于应用程序理解和操作的数据结构。
常见的视频元数据非常多,但我们最常关心的通常包括:
duration
size
bit_rate
format_name
mp4
mov
webm
filename
codec_name
h264
vp9
width
height
avg_frame_rate
25/1
30/1
display_aspect_ratio
16:9
bit_rate
tags
rotate
codec_name
aac
mp3
sample_rate
44100
channels
1
2
bit_rate
要获取更详细的信息,
PHP-FFMpeg
ffprobe
ffprobe
在
ffprobe
Probe
getFormat()
getStreams()
getStreams()
StreamCollection
videos()
audios()
first()
每个流对象(
VideoStream
AudioStream
get()
width
height
codec_name
ffprobe
ffprobe -v quiet -print_format json -show_format -show_streams your_video.mp4
处理大型视频文件或需要批量提取元数据时,性能和错误处理是不能忽视的环节。这和处理其他耗时操作的逻辑是相通的,但视频处理有其特殊性。
性能考量:
ffprobe
FFMpeg
ffprobe
ffprobe
ffprobe
FFMpeg
FFMpeg
ffprobe
ffprobe
PHP-FFMpeg
ffprobe
show_streams
show_format
错误处理:
file_exists()
is_readable()
PHP-FFMpeg
FFMpeg\Exception\FFMpegException
FFMpeg
ffprobe
try-catch
ffprobe
FFMpeg::create()
timeout
将这些考量融入到你的设计和代码中,你的视频处理系统将更加健壮和高效。
以上就是Symfony 怎样将视频元数据转为数组的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号