PHP大佬必看！零依赖媒体处理工具：转码、推拉流、HLS、H.264重编码全搞定

项目简介

纯 PHP 8.1+ 实现的轻量级媒体处理工具包，零外部依赖（无需 FFmpeg）。
支持 FLV、FMP4、MP4、HLS 互转，直播流网关、推流、拉流、转播，以及 H.264 解码 + 缩放 + 重新编码（Baseline Profile）。

📋 目录

• 项目简介
• 核心功能
• 环境依赖
• 安装
• 快速开始
• 高级功能
  • FLV 直播网关
  • 静态文件网关
  • 推流客户端
  • 拉流客户端
  • 直播转发（转播）
• 测试与播放
• 应用场景
• H.264 重编码详解
  • FLV → HLS 多码率示例
  • FLV → FLV 重编码示例
  • MP4 → MP4 重编码示例
  • 水印工具
• 技术说明
• 开源协议 & 免责声明
• 联系方式

🎯 核心功能

环境依赖

💡 无需 FFmpeg，无需任何第三方二进制程序，全部纯 PHP 实现。

🚀 安装

composer require xiaosongshu/flv2mp4

📚 快速开始

<?php

declare(strict_types=1);
require_once __DIR__ . '/vendor/autoload.php';

ini_set('memory_limit', '512M');

$file = __DIR__ . '/test.flv';

// 1. FLV → 混合 fMP4 切片
\Xiaosongshu\Flv2mp4\Client::runFlv2Fmp4Mixed($file, __DIR__ . '/output_merge');

// 2. FLV → 分离 fMP4 切片（音视频独立）
\Xiaosongshu\Flv2mp4\Client::runFlv2Fmp4Separate($file, __DIR__ . '/output_separate');

// 3. FLV → HLS
\Xiaosongshu\Flv2mp4\Client::runFlv2Hls($file, __DIR__ . '/hls');

// 4. HLS → FLV
\Xiaosongshu\Flv2mp4\Client::runHls2Flv(__DIR__ . '/hls/index.m3u8', __DIR__ . '/output.flv');

// 5. MP4 → FLV
\Xiaosongshu\Flv2mp4\Client::runMp42Flv(__DIR__ . '/test.mp4', __DIR__ . '/output.flv');

// 6. FLV → MP4
\Xiaosongshu\Flv2mp4\Client::runFlv2Mp4($file, __DIR__ . '/output.mp4');

// 7. fMP4 → FLV（混合/分离均支持）
\Xiaosongshu\Flv2mp4\Client::runFmp42Flv(__DIR__ . '/output_merge/index.m3u8', __DIR__ . '/output.flv');

🌐 高级功能

FLV 直播网关

支持多级代理部署，实现高并发直播流转发。新建文件flvGateway.php，内容如下:

<?php
require_once __DIR__ . '/vendor/autoload.php';
$gateway = new \Xiaosongshu\Flv2mp4\manage\FlvGateway(8080, 'http://127.0.0.1:8501');
$gateway->debug = true;
$gateway->start();

启动flv网关

php flvGateway.php

静态文件网关

轻量级 HTTP 文件服务器，支持目录浏览开关。新建文件fileGateway.php，内容如下:

<?php
require_once __DIR__ . '/vendor/autoload.php';
$server = new \Xiaosongshu\Flv2mp4\manage\FileGateway( '0.0.0.0',8100,__DIR__,false);
$server->debug = true;
$server->start();

启动file网关

php fileGateway.php

推流客户端

支持 HTTP-FLV、WS-FLV、RTMP 三种协议，倍速推流、断线重连。新建文件pusher.php，内容如下:

require_once __DIR__ . '/vendor/autoload.php';
ini_set('memory_limit', '2048M');
$pusher = new \Xiaosongshu\Flv2mp4\Manage\PusherManage(__DIR__."/test.flv", "http://127.0.0.1:8501/live/stream", 1.0, false);
$pusher->start();

启动推流

php pusher.php

拉流客户端

从直播流拉取并保存为本地 FLV，适合录制或调试。新建文件puller.php，内容如下：

require_once __DIR__ . '/vendor/autoload.php';
ini_set('memory_limit', '2048M');
$puller = new \Xiaosongshu\Flv2mp4\Manage\PullerManage("ws://127.0.0.1:8501/live/stream.flv", __DIR__."/pull_record.flv", 0, false);
$puller->start();

启动拉流客户端

php puller.php

直播转发（转播）

一路拉流，同时转发至多个目标地址（支持协议混用）。新建文件forward.php，内容如下：

require_once __DIR__ . '/vendor/autoload.php';
ini_set('memory_limit', '2048M');
$forwarder = new \Xiaosongshu\Flv2mp4\Flv\FlvForwardClient("http://127.0.0.1:8501/a/b.flv", ["rtmp://127.0.0.1:1935/c/d","ws://127.0.0.1:8501/c/e"], 0, true);
$forwarder->start();

启动转播客户端

php forward.php

🧪 测试&推流&播放

🎯 应用场景

• 直播录制：RTMP/FLV 直播流实时转存为 fMP4 / HLS
• 视频回放：录制流随时点播回看
• 流转发：多级网关实现负载均衡与边缘加速
• 离线批处理：批量转换 FLV / MP4 格式
• 伪直播推流：点播文件伪装为直播流推送
• 跨平台转播：一次拉流，同时转发到多个平台
• 多码率 HLS：纯 PHP 实现的 H.264 重编码，生成自适应码率 HLS

🔥 H.264 解码 + 缩放 + 重编码

支持 Baseline Profile 的 H.264 解码、缩放、重新编码，为以下场景提供核心能力：

技术定位：这是一个完整的 H.264 像素处理管道（解码 → 处理 → 编码），不依赖 FFmpeg，纯 PHP 实现。

flv->hls

以下为flv转码多码率hls示例：

<?php

require_once __DIR__ . '/vendor/autoload.php';
ini_set('memory_limit', '2048M');
$profiles = [
 // 不同码率分别配置
 '240p' => [ 'width' => 426,      // 或 424，保持 16:9 比例即可
 'height' => 240, 'bitrate' => 300000, // 300 Kbps（视频码率）
 'fps' => 24, 'audioBitrate' => 48000, // 48 Kbps 'qp' => 30,          // 保持 30 以确保稳定性
 'watermark'=>true,     // 是否添加水印
 'watermark_file'=> __DIR__."/src/Static/watermark_80x16.yuv",// 水印文件
 ]];
$generator = new \Xiaosongshu\Flv2mp4\Recode\PurePhpHlsGenerator($profiles, __DIR__ . '/hls/output');
$generator->processFlv(__DIR__ . '/input.flv');
echo "索引地址: hls/output/master.m3u8\n";
echo "所有处理完成！\n";

flv->flv

将flv使用新的码率编码

<?php
require_once __DIR__ . '/vendor/autoload.php';
ini_set('memory_limit', '2048M');

$config = [
 'width' => 320,        // 目标宽度，0 = 保持原分辨率
 'height' => 180,       // 目标高度，0 = 保持原分辨率
 'bitrate' => 150000,   // 目标码率（bps），0 = 使用 QP 模式
 'fps' => 15,           // 目标帧率
 'qp' => 30,            // QP 质量参数（码率为 0 时生效）
 'watermark'=>true,     // 是否添加水印
 'watermark_file'=> __DIR__."/src/Static/watermark_80x16.yuv",// 水印文件
];

$recoder = new \Xiaosongshu\Flv2mp4\Recode\FlvRecoder($config);
$recoder->setMaxFrames(50);  // 可选：限制处理帧数
$recoder->processFlv(__DIR__ . '/input.flv', __DIR__.'/output.flv');
echo "flv重编码完成\r\n";

mp4->mp4

将mp4文件使用新的码率编码

<?php
require_once __DIR__ . '/vendor/autoload.php';
ini_set('memory_limit', '2048M');

$config = [
 'width' => 320,        // 目标宽度，0 = 保持原分辨率
 'height' => 180,       // 目标高度，0 = 保持原分辨率
 'bitrate' => 150000,   // 目标码率（bps），0 = 使用 QP 模式
 'fps' => 15,           // 目标帧率
 'qp' => 30,            // QP 质量参数（码率为 0 时生效）
 'watermark'=>true,     // 是否添加水印
 'watermark_file'=> __DIR__."/src/Static/watermark_80x16.yuv",// 水印文件
];
$recoder = new \Xiaosongshu\Flv2mp4\Recode\Mp4Recoder($config);
$recoder->setMaxFrames(50); // 可选：限制处理帧数
$recoder->processMp4(__DIR__ . '/input.mp4', __DIR__ . '/output.mp4');
echo "mp4重编码完成\r\n";

• 添加水印的时候，需要使用yuv格式文件，并且文件名称如上面的示例所示，必须包含水印文件的宽高（watermark_{width}x{height}.yuv）。工具会自动从文件名解析宽高（如 watermark_80x16.yuv → 宽 80，高 16），请确保文件名格式准确。
• 重编码模块提供了 YUV 像素级操作接口，你可以基于此实现自定义功能，如添加字幕、画中画、视频拼接等。
• h264详细使用方法见README。

已支持的重编码特性

• I 帧解码与编码（完全精确，INF dB）
• P 帧解码与编码（Baseline Profile）
• 帧内预测：4x4（9种模式）+ 16x16（4种模式）
• 帧间预测：P 帧运动估计（菱形搜索优化）
• 1/4 像素精度：6-tap 滤波器插值
• CAVLC 熵编码（Baseline Profile）
• 分辨率缩放（解码后 YUV 缩放 → 重新编码）
• 码率控制（通过 QP 参数调节）
• B 帧支持（计划中，需扩展至 Main Profile 并实现双向预测）
• CABAC 熵编码（计划中，Main Profile 支持）

⚠️ 性能说明：当前 H.264 重编码模块由纯 PHP 实现，适用于短时长视频（建议 ≤ 10 秒）的离线处理或功能验证。对于长视频或高分辨率转码，建议使用 FFmpeg 等专业工具。

水印生成工具

本项目提供php生成水印yuv功能，GD 扩展优先，无 GD 时自动降级为点阵字体。

• generateFromText() 生成文字水印 YUV， GD 扩展优先，无 GD 时自动降级为点阵字体,内置点阵字体仅支持 ASCII 字符（英文字母、数字、英文标点）
• generateFromImage() 从图片生成水印 YUV，需要 GD 扩展，支持png/jpg

使用文字生成水印文件

<?php
require_once __DIR__ . '/vendor/autoload.php';

use Xiaosongshu\Flv2mp4\Codec\WatermarkUtil;

echo "=== 测试 WatermarkUtil ===\n\n";
// 测试1：生成文字水印
echo "1. 生成文字水印 (xiaosongshu, 80x16)...\n";$outputFile1 = __DIR__ . '/test_wm_text.yuv';
$start = microtime(true);
$result = WatermarkUtil::generateFromText(
 'xiaosongshu', $outputFile1, 80, 16,
 [ 'fontSize' => 5, // 内置字体大小 1-5 `fontSize` 取值范围 1-5（数字越大字体越大），内置点阵字体仅支持 ASCII 字符。
 'fontColor' => [255, 255, 255], 'bgColor' => [0, 0, 0], ]);
$cost = round(microtime(true) - $start, 3);
if ($result && file_exists($outputFile1)) {
 $size = filesize($outputFile1); $expectedSize = 80 * 16 + (80 * 16 >> 1); echo " 成功! 文件大小: {$size} 字节 (期望: {$expectedSize}) - 耗时: {$cost}s\n";
 if ($size === $expectedSize) { echo " ✅ 文件尺寸正确\n";
 } else { echo " ❌ 文件尺寸不匹配\n";
 }} else {
 echo " ❌ 生成失败\n";
}

使用图片生成水印文件

• 需要php安装gd扩展

<?php

require_once __DIR__ . '/vendor/autoload.php';

use Xiaosongshu\Flv2mp4\Codec\WatermarkUtil;

echo "=== 测试 WatermarkUtil ===\n\n";
// 测试1：从图片生成水印
echo "1. 从图片生成水印 (xiaosongshu, 80x16)...\n";$outputFile1 = __DIR__ . '/test_wm_copy_80x16.yuv';
$start = microtime(true);
$result = WatermarkUtil::generateFromImage(
 __DIR__."/watermark_80x16.png", $outputFile1, 80, 16,);
$cost = round(microtime(true) - $start, 3);
if ($result && file_exists($outputFile1)) {
 $size = filesize($outputFile1); $expectedSize = 80 * 16 + (80 * 16 >> 1); echo " 成功! 文件大小: {$size} 字节 (期望: {$expectedSize}) - 耗时: {$cost}s\n";
 if ($size === $expectedSize) { echo " ✅ 文件尺寸正确\n";
 } else { echo " ❌ 文件尺寸不匹配\n";
 }} else {
 echo " ❌ 生成失败\n";
}

🔧 技术说明

• 纯 PHP 8.1+ 实现，无 FFmpeg 依赖
• 当前项目最初主要是为 xiaosongshu/rtmp_server 提供服务
• 建议使用 PHPStan Level 8 进行静态分析

开源协议 & 免责声明

本项目基于 Apache License 2.0 开源，可自由使用、修改、分发（含商业用途）。
代码按“现状”（AS IS）提供，不提供任何明示或暗示的担保。作者不对因使用本软件而产生的任何损害承担责任。

📧 联系方式

• 📬 邮箱：2723659854@qq.com
• 🐙 GitHub：2723659854

本作品采用《CC 协议》，转载必须注明作者和本文链接