Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zikwall/m3u-content-parser
PHP parser m3u content
https://github.com/zikwall/m3u-content-parser
content m3u m3u-parser m3u-playlist m3u8 parser php playlist
Last synced: 3 months ago
JSON representation
PHP parser m3u content
- Host: GitHub
- URL: https://github.com/zikwall/m3u-content-parser
- Owner: zikwall
- Created: 2020-01-29T05:43:22.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2022-04-06T12:35:47.000Z (almost 3 years ago)
- Last Synced: 2024-10-14T11:42:37.054Z (4 months ago)
- Topics: content, m3u, m3u-parser, m3u-playlist, m3u8, parser, php, playlist
- Language: PHP
- Size: 26.4 KB
- Stars: 12
- Watchers: 4
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
m3u Content Parser
Minimalistic, functional and easy to use playlist parser
### Example usage
```php
use zikwall\m3ucontentparser\M3UContentParser;
use zikwall\m3ucontentparser\M3UItem;
$parser = new M3UContentParser('https://iptv-org.github.io/iptv/countries/ru.m3u');
$parser->parse();
foreach ($parser->limit(20)->all() as $item) {
/**
* @var $item M3UItem
*/
echo
$item->getTvgName(), PHP_EOL,
$item->getTvgLogo(), PHP_EOL,
$item->getTvgUrl(), PHP_EOL,
$item->getGroupTitle(), PHP_EOL,
$item->getId(), PHP_EOL;
$item->getGroupId(), PHP_EOL,
$item->getLanguage(), PHP_EOL,
$item->getCountry();
}
```
### More example
```php
// rewrite current m3u content
foreach ($parser->all() as $item) {
/**
* @var $item M3UItem
*/
$item
->replaceTvgName('UNNAMED ITEM')
->replaceTvgLogo('NEW LOGO URL')
->replaceTvgUrl('CHANE NEW URL');
}
echo $parser->rewriteM3UFile();
output example:
#EXTM3U url-tvg="http://iptvx.one/epg/epg.xml.gz"
#EXTINF:-1 group-title="Новости",UNNAMED ITEM
CHANE NEW URL
#EXTINF:-1 group-title="Новости",UNNAMED ITEM
CHANE NEW URL
```
### Segment Parser
```php
use zikwall\m3ucontentparser\SegmentM3U;
$segmant = new SegmentM3U();
$fragment->attachSource('examples/segments/index.m3u8')->parse();
print_r($segment->getFragments());
print_r($segment->getSegments());
print_r($segment->getTime());
var_dump($segment->getIsEnding());
```
### Complex sample
```php
use zikwall\m3ucontentparser\M3UContentParser;
use zikwall\m3ucontentparser\SegmentM3U;
use zikwall\m3ucontentparser\M3UItem;
use zikwall\m3ucontentparser\FragmentM3UItem;
$parser = new M3UContentParser('https://iptv-org.github.io/iptv/countries/ru.m3u');
$parser->parse();
foreach ($parser->limit(10)->offset(10)->all() as $item) {
/**
* @var $item M3UItem
*/
$segment = new SegmentM3U();
$segment->attachSource($item->getTvgUrl())->parse();
if ($segment->getIsFragmentSource() === true) {
/**
* @var $fragment FragmentM3UItem
*/
echo $segment->getCleanSource(), PHP_EOL;
foreach ($segment->getFragments() as $fragment) {
$subSegment = new SegmentM3U();
$subSegment->attachSource($segment->getNewSource($fragment->fragment))->parse();
echo $segment->getNewSource($fragment->fragment), PHP_EOL;
}
continue;
}
// ... conventional segment processing
foreach ($segment->getSegments() as $segmentItem) {
/**
* @var $segmentItem SegmentM3UItem
*/
echo $segment->getNewSource($segmentItem->segment), PHP_EOL;
// display generated chunk links
// http://xxxxx/stream8/stream2020_2_23_13_44_7-65006.ts
// http://xxxxx/stream8/stream2020_2_23_13_44_18-65007.ts
// http://xxxxx/stream8/stream2020_2_23_13_44_28-65008.ts
// ...
}
}
```
### Seemed complicated? It is even easier!
```php
$segment = new SegmentM3U();
$segment->attachSource('http://mhd.xxxxxxx.tv/p/k5OqlMqeQONvANUJOq9GFQ,1582553567/streaming/ntvnn/324/variable.m3u8')->parse();
if ($segment->getIsFragmentSource() === true) {
$segments = [];
foreach ($segment->getFragments() as $fragment) {
$subSegment = new SegmentM3U();
$subSegment->attachSource($segment->getNewSource($fragment->fragment))->parse();
echo $segment->getNewSource($fragment->fragment), PHP_EOL;
/**
* Get total duration
*/
echo sprintf('Duration is: %0.2f seconds', $subSegment->getDuration()), PHP_EOL;
foreach ($subSegment->getSegments() as $sgmt) {
echo $subSegment->getNewSource($sgmt->segment), PHP_EOL;
}
}
/**
* Original: http://mhd.xxxxx.tv/p/k5OqlMqeQONvANUJOq9GFQ,1582553567/streaming/ntvnn/324/variable.m3u8
* Cleaning: http://mhd.xxxxx.tv/p/k5OqlMqeQONvANUJOq9GFQ,1582553567/streaming/ntvnn/324/vl2w/
*
* Return stream links (FRAGMENTS):
* - http://mhd.xxxxx.tv/p/k5OqlMqeQONvANUJOq9GFQ,1582553567/streaming/ntvnn/324/vl2w/playlist.m3u8 // LOW
* - http://mhd.xxxxx.tv/p/k5OqlMqeQONvANUJOq9GFQ,1582553567/streaming/ntvnn/324/vm2w/playlist.m3u8 // MIDDLE
* - http://mhd.xxxxx.tv/p/k5OqlMqeQONvANUJOq9GFQ,1582553567/streaming/ntvnn/324/vh1w/playlist.m3u8 // HIGH
*/
/**
* Each all fragments return SegmentM3UItem Object
* http://mhd.xxxxxxx.tv/p/k5OqlMqeQONvANUJOq9GFQ,1582553567/streaming/ntvnn/324/vh1w/playlist.m3u8
*
* Array
* (
* [0] => zikwall\m3ucontentparser\SegmentM3UItem Object
* (
* [duration] => 6
* [segment] => segment-1582439833-08914115.ts
* )
* [1] => zikwall\m3ucontentparser\SegmentM3UItem Object
* (
* [duration] => 6
* [segment] => segment-1582439833-08914116.ts
* )
* ...
*/
/**
* Convert to valid links, example:
*
* http://mhd.xxxxxxx.tv/p/k5OqlMqeQONvANUJOq9GFQ,1582553567/streaming/ntvnn/324/vh1w/segment-1582439833-08914207.ts
* http://mhd.xxxxxxx.tv/p/k5OqlMqeQONvANUJOq9GFQ,1582553567/streaming/ntvnn/324/vh1w/segment-1582439833-08914208.ts
* http://mhd.xxxxxxx.tv/p/k5OqlMqeQONvANUJOq9GFQ,1582553567/streaming/ntvnn/324/vh1w/segment-1582439833-08914209.ts
* http://mhd.xxxxxxx.tv/p/k5OqlMqeQONvANUJOq9GFQ,1582553567/streaming/ntvnn/324/vh1w/segment-1582439833-08914210.ts
* http://mhd.xxxxxxx.tv/p/k5OqlMqeQONvANUJOq9GFQ,1582553567/streaming/ntvnn/324/vh1w/segment-1582439833-08914211.ts
* http://mhd.xxxxxxx.tv/p/k5OqlMqeQONvANUJOq9GFQ,1582553567/streaming/ntvnn/324/vh1w/segment-1582439833-08914212.ts
* http://mhd.xxxxxxx.tv/p/k5OqlMqeQONvANUJOq9GFQ,1582553567/streaming/ntvnn/324/vh1w/segment-1582439833-08914213.ts
* http://mhd.xxxxxxx.tv/p/k5OqlMqeQONvANUJOq9GFQ,1582553567/streaming/ntvnn/324/vh1w/segment-1582439833-08914214.ts
* http://mhd.xxxxxxx.tv/p/k5OqlMqeQONvANUJOq9GFQ,1582553567/streaming/ntvnn/324/vh1w/segment-1582439833-08914215.ts
*/
}
```
### Even easier
```php
$segment = new SegmentM3U();
$segment->attachSource('http://hls.kinoplayer.co/hls/PaSSagir.iz.SanFranCissko.2O17.HDRip/playlist.m3u8')->parse();
foreach ($segment->getSegments() as $sgmt) {
echo $segment->getNewSource($sgmt->segment), PHP_EOL;
}
echo sprintf('Duration is: %0.2f seconds', $segment->getDuration()), PHP_EOL;
```
### More examples Segment parser
You can try different combinations of examples yourself
### API
1. The parser constructor accepts a link or file path:
```php
$parser = new M3UContentParser('https://iptv-org.github.io/iptv/countries/ru.m3u');
```
2. Parsing is called by the same method:
```php
$parser->parse();
```
### Methods in m3u parser
- [x] `getCahce()`
- [x] `getResfresh()`
- [x] `getTvgUrl()`
- [x] `limit(int)`
- [x] `offset(int)`
- [x] `all()`
- [x] `getItems()`
- [x] `rewriteM3UFile()`
### Methods in m3u item object
- [x] `getId()`
- [x] `getTvgId()`
- [x] `getTvgName()`
- [x] `getTvgUrl()`
- [x] `getTvgLogo()`
- [x] `getTvgShift()`
- [x] `getGroupId()`
- [x] `getGroupTitle()`
- [x] `getExtGrp()`
- [x] `getCensored()`
- [x] `getLanguage()`
- [x] `getCountry()`
- [x] `getAudioTrack()`
- [x] `getAudioTrackNum()`
- [x] `getExtraAttributes()`
### API Segment
- [x] `getFragments()` return array of tracks with props
- [x] `getSegments()` return array of segments in track
- [x] `getTime()` return array of timecodes: hours, minutes, seconds and string format HH:MM:SS & original value
- [x] `getDuration()` return float value duration of seconds
- [x] `getIsEnding()` return bool value, indicates whether the stream has an ending or not
- [x] `getIsFragmentSource()`
- [x] `getNewSource(string $sub_source)`
- [x] `getHashHeaders()`
- [x] `getDirtyItems()`
### Installation
`composer require zikwall/m3u-content-parser`
### Develop Mode
```json
{
"minimum-stability": "dev",
"repositories": [
{
"type": "git",
"url": "https://github.com/zikwall/m3u-content-parser.git"
}
],
"require": {
"zikwall/m3u-content-parser": "dev-master"
}
}
```
#### Questions?
For all questions and suggestions - welcome to Issues