PHPackages                             maplesnow/php-ffmpeg - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. maplesnow/php-ffmpeg

ActiveLibrary[Image & Media](/categories/media)

maplesnow/php-ffmpeg
====================

PHP FFMpeg - Video Transcoding & Streaming

v1.0.0(6y ago)035MITPHPPHP ^7.0

Since Sep 23Pushed 6y ago1 watchersCompare

[ Source](https://github.com/summerway/php-mpeg)[ Packagist](https://packagist.org/packages/maplesnow/php-ffmpeg)[ Docs](https://github.com/summerway/php-ffmpeg)[ RSS](/packages/maplesnow-php-ffmpeg/feed)WikiDiscussions master Synced 6d ago

READMEChangelogDependencies (2)Versions (3)Used By (0)

概述
--

[](#概述)

该工具由[aminyazdanpanah/PHP-FFmpeg-video-streaming](https://github.com/aminyazdanpanah/PHP-FFmpeg-video-streaming)改写而成，兼容php7.0及以上版本。
将ffmpeg常用操作包装简化，支持视频转码(video->mp4)和视频呢转流(video->dash、video->hls)功能。 视频文件可选自本地或者[七牛](https://qiniu.com)，转化后文件也可选择保留本地目录或者存储到七牛云端。

要求
--

[](#要求)

1. 该工具要求7.0及以上。
2. 依赖 **[FFMpeg](https://ffmpeg.org/download.html)**。需要系统支持`FFMpeg` 和 `FFProbe`。

安装
--

[](#安装)

```
composer require maplesnow/php-ffmpeg-video-streaming
```

### 配置

[](#配置)

指定ffmpeg初始配置参数

```
$config = [
    'ffmpeg.binaries'  => '/usr/bin/ffmpeg',
    'ffprobe.binaries' => '/usr/bin/ffprobe',
    'timeout'          => 3600, // The timeout for the underlying process
    'ffmpeg.threads'   => 12,   // The number of threads that FFMpeg should use
];

$ffmpeg = Streaming\FFMpeg::create($config);
```

### 打开文件

[](#打开文件)

目前支持2种打开方式

#### 本地

[](#本地)

```
$video = $ffmpeg->open('/var/www/media/videos/test.mp4');
```

#### 七牛云

[](#七牛云)

```
$qiniu = new \Streaming\Qiniu($accessKey,$secretKey);
$video = $ffmpeg->fromQiniu($qiniu,$url);
```

### 视频转码

[](#视频转码)

mp4格式输出

```
$video->MP4()->X264()->save('mp4/demo.mp4');
```

### DASH

[](#dash)

**[Dynamic Adaptive Streaming over HTTP (DASH)](https://en.wikipedia.org/wiki/Dynamic_Adaptive_Streaming_over_HTTP)**, also known as MPEG-DASH, is an adaptive bitrate streaming technique that enables high quality streaming of media content over the Internet delivered from conventional HTTP web servers.

```
$video->DASH()
    ->HEVC() // Format of the video. Alternatives: X264() and VP9()
    ->autoGenerateRepresentations() // Auto generate representations
    ->setAdaption('id=0,streams=v id=1,streams=a') // Set the adaption.
    ->save(); // It can be passed a path to the method or it can be null
```

自定义`Representation`参数

```
use Streaming\Representation;

$rep_1 = (new Representation())->setKiloBitrate(800)->setResize(1080 , 720);
$rep_2 = (new Representation())->setKiloBitrate(300)->setResize(640 , 360);

$video->DASH()
    ->HEVC()
    ->addRepresentation($rep_1) // Add a representation
    ->addRepresentation($rep_2)
    ->setAdaption('id=0,streams=v id=1,streams=a') // Set a adaption.
    ->save('dash/test.mpd');
```

更多参数详见 **[DASH options](https://ffmpeg.org/ffmpeg-formats.html#dash-2)**

### HLS

[](#hls)

**[HTTP Live Streaming (also known as HLS)](https://en.wikipedia.org/wiki/HTTP_Live_Streaming)** is an HTTP-based adaptive bitrate streaming communications protocol implemented by Apple Inc. as part of its QuickTime, Safari, OS X, and iOS software. Client implementations are also available in Microsoft Edge, Firefox and some versions of Google Chrome. Support is widespread in streaming media servers.

```
$video->HLS()
    ->X264()
    ->autoGenerateRepresentations([720, 360]) // You can limit the numbers of representatons
    ->save();
```

自定义`Representation`参数

```
use Streaming\Representation;

$rep_1 = (new Representation())->setKiloBitrate(1000)->setResize(1080 , 720);
$rep_2 = (new Representation())->setKiloBitrate(500)->setResize(640 , 360);
$rep_3 = (new Representation())->setKiloBitrate(200)->setResize(480 , 270);

$video->HLS()
    ->X264()
    ->setHlsBaseUrl('https://bucket.s3-us-west-1.amazonaws.com/videos') // Add a base URL
    ->addRepresentation($rep_1)
    ->addRepresentation($rep_2)
    ->addRepresentation($rep_3)
    ->setHlsTime(5) // Set Hls Time. Default value is 10
    ->setHlsAllowCache(false) // Default value is true
    ->save();
```

**NOTE:** 不能使用`HEVC` 和 `VP9` 格式

#### HLS加密

[](#hls加密)

The encryption process requires some kind of secret (key) together with an encryption algorithm. HLS uses AES in cipher block chaining (CBC) mode. This means each block is encrypted using the ciphertext of the preceding block. [Learn more](https://en.wikipedia.org/wiki/Block_cipher_mode_of_operation)

You need to pass both `URL to the key` and `path to save a random key` to the `generateRandomKeyInfo` method:

```
//A path you want to save a random key on your server
$save_to = '/var/www/my_website_project/keys/enc.key';

//A URL (or a path) to access the key on your website
$url = 'https://www.aminyazdanpanah.com/keys/enc.key';// or '/keys/enc.key';

$video->HLS()
    ->X264()
    ->setTsSubDirectory('ts_files')// put all ts files in a subdirectory
    ->generateRandomKeyInfo($url, $save_to)
    ->autoGenerateRepresentations([1080, 480, 240])
    ->save('/var/www/media/videos/hls/test.m3u8');
```

**NOTE:** It is very important to protect your key on your website using a token or a session/cookie(**It is highly recommended**).

See **[HLS options](https://ffmpeg.org/ffmpeg-formats.html#hls-2)** for more information.

### 保存文件

[](#保存文件)

两种文件存储方式

#### 本地保存

[](#本地保存)

指定目录保存文件

```
$dash = $video->DASH()
            ->HEVC()
            ->autoGenerateRepresentations()
            ->setAdaption('id=0,streams=v id=1,streams=a');

$dash->save('dash/test.mpd');
```

默认保存目录为文件来源目录

```
$hls = $video->HLS()
            ->X264()
            ->autoGenerateRepresentations();

$hls->save();
```

#### 保存至七牛云

[](#保存至七牛云)

```
$mp4 = $video->MP4()->X264();
$qiniu = new \Streaming\Qiniu($accessKey,$secretKey);
$mp4->save2qiniu($qiniu,'bucket-name')
```

开源的播放插件
-------

[](#开源的播放插件)

你可以用下列播放你转换的流文件

- **WEB**
    - DASH and HLS: **[video.js](https://github.com/videojs/video.js)**
    - DASH: **[dash.js](https://github.com/Dash-Industry-Forum/dash.js)**

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

2421d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e3058701be7b10c7b12972629160b82b9f4dcae7c0b95ed09e7d695fb542552a?d=identicon)[mapleSnow](/maintainers/mapleSnow)

---

Top Contributors

[![summerway](https://avatars.githubusercontent.com/u/5858441?v=4)](https://github.com/summerway "summerway (1 commits)")

---

Tags

streamingvideohlsdashvideostreaming

### Embed Badge

![Health badge](/badges/maplesnow-php-ffmpeg/health.svg)

```
[![Health](https://phpackages.com/badges/maplesnow-php-ffmpeg/health.svg)](https://phpackages.com/packages/maplesnow-php-ffmpeg)
```

###  Alternatives

[aminyazdanpanah/php-ffmpeg-video-streaming

📼 PHP FFMpeg - Video Streaming - DASH, HLS http://video.aminyazdanpanah.com

542275.0k8](/packages/aminyazdanpanah-php-ffmpeg-video-streaming)[happyworm/jplayer

jPlayer allows you to create a media player with a consistent interface and experience across all browsers.

4.6k114.2k1](/packages/happyworm-jplayer)[opentok/opentok

OpenTok is a platform for creating real time streaming video applications, created by TokBox.

1413.0M10](/packages/opentok-opentok)[aminyazdanpanah/php-shaka

Shaka PHP is a library that uses Shaka Packager for DASH and HLS packaging and encryption, supporting Common Encryption for Widevine and other DRM Systems.

939.0k1](/packages/aminyazdanpanah-php-shaka)[mostafaznv/nova-video

Video Field for Laravel Nova

22398.0k1](/packages/mostafaznv-nova-video)[mehrdad-dadkhah/hls-video-generater

PHP library for generating video m3u8 playlist

241.4k](/packages/mehrdad-dadkhah-hls-video-generater)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)