PHP 字幕转换工具使用教程

1. 项目介绍

PHP Subtitles 是一个开源的 PHP 库，用于转换和操作字幕文件。它支持多种字幕格式，包括 SubRip (.srt)、WebVTT (.vtt)、Scenarist (.scc)、EBU STL、Spruce Technologies SubTitles、Youtube Subtitles (.sbv)、SubViewer (.sub)、MicroDVD (.sub)、Advanced Sub Station (.ass)、Netflix Timed Text (.dfxp)、TTML (.ttml)、SAMI (.smi)、QuickTime (.qt.txt)、Rich text format (.rtf)、DOCX (.docx)、LyRiCs (.lrc)、Comma separated values (.csv) 和 Plaintext (.txt)。该库可以轻松地将一种字幕格式转换为另一种格式，并提供了丰富的API来操作字幕内容。

2. 项目快速启动

首先，确保你的环境已经安装了 PHP。接下来，你可以通过 Composer 安装 PHP Subtitles：

composer require mantas-done/subtitles

以下是一个简单的示例，演示如何将 SubRip 格式 (.srt) 的字幕转换为 WebVTT 格式 (.vtt)：

use Done\Subtitles\Subtitles;

// 转换字幕
Subtitles::convert('subtitles.srt', 'subtitles.vtt');

// 如果你需要指定输出格式，可以使用以下代码
Subtitles::convert('subtitles1', 'subtitles2', [
    'output_format' => 'vtt'
]);

3. 应用案例和最佳实践

转换字幕格式

如果你想将字幕文件转换为其他格式，可以使用 convert 方法。这个方法接受三个参数：输入文件路径、输出文件路径和可选的格式参数。

Subtitles::convert('input.srt', 'output.vtt', [
    'output_format' => 'vtt'
]);

读取和保存字幕

你可以从文件中读取字幕，然后保存到另一个文件：

// 从文件加载字幕
$subtitle = Subtitles::loadFromFile('subtitles.srt');

// 保存字幕到新文件
$subtitle->save('subtitles.vtt');

添加和移除字幕

你可以添加新的字幕条目，或者移除现有的字幕条目：

// 添加字幕
$subtitle->add(0, 5, '这是一段新的字幕文本');

// 移除字幕
$subtitle->remove(0, 5);

修改字幕时间

你可以对字幕的时间进行修改，比如增加或减少时间，或者为整个视频逐步调整时间：

// 为所有字幕增加1秒
$subtitle->shiftTime(1);

// 为特定时间段的字幕减少0.5秒
$subtitle->shiftTime(-0.5, 60, 120);

// 逐步调整时间
$subtitle->shiftTimeGradually(2, 0, 3600);

4. 典型生态项目

目前，PHP Subtitles 已经成为处理字幕转换的流行选择。它被用于多种场景，包括视频内容制作、字幕编辑工具和自动化字幕处理流程。开发者社区持续为该项目贡献代码，修复问题和添加新的字幕格式支持，使其成为一个充满活力的开源项目。