PHPackages                             fideloper/porter - 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. [Parsing & Serialization](/categories/parsing)
4. /
5. fideloper/porter

ActiveLibrary[Parsing & Serialization](/categories/parsing)

fideloper/porter
================

Extendable link-parser and meta-data obtainer for various services such as Vimeo and Youtube

51.7k2PHP

Since Jul 4Pushed 13y ago1 watchersCompare

[ Source](https://github.com/fideloper/Porter)[ Packagist](https://packagist.org/packages/fideloper/porter)[ RSS](/packages/fideloper-porter/feed)WikiDiscussions develop Synced today

READMEChangelogDependenciesVersions (2)Used By (0)

\#Porter [![Total Downloads](https://camo.githubusercontent.com/f057ac4f2a4dad23098aed831907805c06866522fec1fa279b48cfa483440cb5/68747470733a2f2f706f7365722e707567782e6f72672f666964656c6f7065722f706f727465722f646f776e6c6f6164732e706e67)](https://packagist.org/packages/fideloper/porter)
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

[](#porter)

**Extendable url-parser thingy and meta-data obtainer for various services such as Youtube and Vimeo**

[![Sriracha!!!](https://camo.githubusercontent.com/a20d4141fec30281ce47d942eabda8919e9a12ad8f44a1a574e1ea30a54a6660/687474703a2f2f7374617469632d6c332e626c6f67637269746963732e6f72672f30392f31302f30392f3131353834392f30393130303673726972616368612e6a7067)](https://camo.githubusercontent.com/a20d4141fec30281ce47d942eabda8919e9a12ad8f44a1a574e1ea30a54a6660/687474703a2f2f7374617469632d6c332e626c6f67637269746963732e6f72672f30392f31302f30392f3131353834392f30393130303673726972616368612e6a7067)

What does it do?
----------------

[](#what-does-it-do)

Say you have a piece of content, maybe from a user on your site.

```
I love Sriracha sauce!!! I even put it on my Cinnamon Toast Struddle Crunch Tiger Blood Leprechaun cereal!
Here's a video review of it http://www.youtube.com/watch?v=GYamE6G1EZo,
and a spiffy ad for Sriracha Sauce!!! http://vimeo.com/41852814

```

You like how Twitter shows an embed and information about linked Youtube videos, so you figure

> Hey, Twitter is cool! I'm gonna do exactly what Twitter does so I'm cool too!

Well you're in luck! Using this spicy library, you can grab the URLs from content and get meta information about them.

How do I use it?
----------------

[](#how-do-i-use-it)

```
$some_weirdos_comment = "I love Sriracha sauce!!! I even put it on my Cinnamon Toast Struddle Crunch Tiger Blood Leprechaun cereal! Here's a video review of it http://www.youtube.com/watch?v=GYamE6G1EZo, and a spiffy ad for Sriracha Sauce!!! http://vimeo.com/41852814";

$parser = new \Porter\Parser();

// I want YouTooooooob!
$parser->addService( new \Porter\Service\Youtube() );

// I want Vimeooooooooo!
$parser->addService( new \Porter\Service\Vimeo() );

$parsed_urls = $parser->parse( $parser->matchUrls($some_weirdos_comment) );

// ID's Parsed from URLs directly
foreach ( $parsed_urls as $parsed )
{
    $item_id = $parsed->getId(); //Youtube: GYamE6G1EZo, Vimeo: 41852814
}

// Now, let's get fancy with some API requests
foreach ( $parsed_urls as $parsed )
{
    $meta = $parsed->getMetadata( new \Porter\Request\Curl() ); // stdClass of data
}
```

Foreach service (Currently Youtube, Vimeo), you can get:

1. Video ID
2. Meta Data Available via public api
    - ID
    - Image
    - Play Time
    - Title
    - etc

Contribute!
-----------

[](#contribute)

There's room for improvement. For instance:

1. I've abstracted out a Request implementation, when the code using it pretty clearly expects a cURL request to happen (Gives it a URL to grab data from)
2. Only supports Youtube/Vimeo at the moment (Flickr? Twitpic? etc etc)
3. The Parser class loops through each service, and creates a new instance of each service on each iteration. Needed for multiple URLs, but I dislike the implementation.

Licence
-------

[](#licence)

```
MIT

```

###  Health Score

26

—

LowBetter than 41% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity43

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/5ffe7f19bdf080aaa14107239624d682f2e1b139b9459e93b56966649a4d7873?d=identicon)[fideloper](/maintainers/fideloper)

---

Top Contributors

[![fideloper](https://avatars.githubusercontent.com/u/467411?v=4)](https://github.com/fideloper "fideloper (2 commits)")

### Embed Badge

![Health badge](/badges/fideloper-porter/health.svg)

```
[![Health](https://phpackages.com/badges/fideloper-porter/health.svg)](https://phpackages.com/packages/fideloper-porter)
```

###  Alternatives

[mck89/peast

Peast is PHP library that generates AST for JavaScript code

19139.2M47](/packages/mck89-peast)[sauladam/shipment-tracker

Parses tracking information for several carriers, like UPS, USPS, DHL and GLS by simply scraping the data. No need for any kind of API access.

9843.5k](/packages/sauladam-shipment-tracker)[jstewmc/rtf

Read and write Rich Text Format (RTF) documents with PHP

45153.1k6](/packages/jstewmc-rtf)[tcds-io/php-jackson

A lightweight, flexible object serializer for PHP, inspired by FasterXML/jackson

113.2k10](/packages/tcds-io-php-jackson)

PHPackages © 2026

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