PHPackages marcelklehr/link-preview - 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. [Utility & Helpers](/categories/utility) 4. / 5. marcelklehr/link-preview ActiveLibrary[Utility & Helpers](/categories/utility) marcelklehr/link-preview ======================== Link preview generation for PHP with Laravel support v5.0.0(6mo ago)1254.0k—5.4%3MITPHPPHP >=8.1 Since Dec 19Pushed 6mo ago1 watchersCompare [ Source](https://github.com/marcelklehr/link-preview)[ Packagist](https://packagist.org/packages/marcelklehr/link-preview)[ Docs](http://github.com/marcelklehr/link-preview)[ RSS](/packages/marcelklehr-link-preview/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (6)Versions (34)Used By (0) Link Preview ============ [](#link-preview) A PHP class that consumes an HTTP(S) link and returns an array of preview information. Think of Facebook sharing - whenever you paste a link, it goes to specified page and fetches some details. Initially based on [kasp3r/link-preview](https://github.com/kasp3r/link-preview) that seems to be abandoned. This fork is special in that it doesn't come with any specific HTTP implementation but instead lets you inject a PSR-17 Factory and a PSR-18 Client. Giving you the freedom to use whatever you like. Dependencies ------------ [](#dependencies) - PHP >= 7.0 - Symfony DomCrawler >= 3.0 Installation via Composer ------------------------- [](#installation-via-composer) To install simply run: ``` composer require marcelklehr/link-preview ``` Or add it to `composer.json` manually: ``` { "require": { "marcelklehr/link-preview": "~1.2" } } ``` Direct usage ------------ [](#direct-usage) ``` use Marcelklehr\LinkPreview\Client; $previewClient = new Client(/*your http implementation here*/); // Get previews from all available parsers $previews = $previewClient->getLink('https://www.boogiecall.com/en/Melbourne')->getPreviews(); // Only get preview data from specific parser $preview = $previewClient->getPreview('general'); // Convert output to array $preview = $preview->toArray(); ``` **Output** ``` array(4) { ["basic"]=>array(2){ ["title"]=> string(44) "Events, parties & live concerts in Melbourne" ["description"]=> string(107) "List of events in Melbourne. Nightlife, best parties and concerts in Melbourne, event listings and reviews." } ["image"]=>array(2){ ["large"]=> string(94) "https://cdn.boogiecall.com/media/images/872398e3d9598c494a2bed72268bf018_1440575488_7314_s.jpg" ["small"]=> string(94) "https://cdn.boogiecall.com/media/images/872398e3d9598c494a2bed72268bf018_1440575488_7314_s.jpg" } } ``` ### YouTube example [](#youtube-example) ``` use Marcelklehr\LinkPreview\Client; $previewClient = new Client(/*your http implementation here*/); // Only parse YouTube specific information $preview = $previewClient->getLink('https://www.youtube.com/watch?v=v1uKhwN6FtA')->getPreview('youtube'); var_dump($preview->toArray()); ``` **Output** ``` array(2) { ["video"]=>array(2) { ["embed"]=> string(128) "" ["id"]=> string(11) "v1uKhwN6FtA" } } ``` License ------- [](#license) The MIT License (MIT) Copyright (c) 2016 Denis Mysenko Copyright (c) 2018 Marcel Klehr Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ### Health Score 55 — FairBetter than 98% of packages Maintenance67 Regular maintenance activity Popularity36 Limited adoption so far Community16 Small or concentrated contributor base Maturity83 Battle-tested with a long release history Bus Factor2 2 contributors hold 50%+ of commits 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 Every ~140 days Recently: every ~437 days Total 32 Last Release 191d ago Major Versions v1.2.11 → v2.0.02018-01-28 v2.0.6 → v3.0.02018-08-27 v3.0.7 → v4.0.02025-11-08 v4.0.0 → v5.0.02025-11-08 PHP version history (4 changes)1.0.0PHP >=5.3.0 v1.2.3PHP >=5.5.0 v3.0.7PHP >=7.0 v4.0.0PHP >=8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/044b0f5be5f9749e8ffccb5db212f3418136b7fac9020e3e97b76c2c259f9ba8?d=identicon)[marcelklehr](/maintainers/marcelklehr) --- Top Contributors [![dusterio](https://avatars.githubusercontent.com/u/11039918?v=4)](https://github.com/dusterio "dusterio (41 commits)")[![marcelklehr](https://avatars.githubusercontent.com/u/986878?v=4)](https://github.com/marcelklehr "marcelklehr (31 commits)")[![kasp3r](https://avatars.githubusercontent.com/u/798379?v=4)](https://github.com/kasp3r "kasp3r (19 commits)")[![service-paradis](https://avatars.githubusercontent.com/u/12817388?v=4)](https://github.com/service-paradis "service-paradis (2 commits)")[![edueo](https://avatars.githubusercontent.com/u/6653555?v=4)](https://github.com/edueo "edueo (2 commits)")[![j3j5](https://avatars.githubusercontent.com/u/1239921?v=4)](https://github.com/j3j5 "j3j5 (1 commits)")[![benwilkins](https://avatars.githubusercontent.com/u/1360229?v=4)](https://github.com/benwilkins "benwilkins (1 commits)") --- Tags urlphplaravelpreviewscraping ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/marcelklehr-link-preview/health.svg) ``` [![Health](https://phpackages.com/badges/marcelklehr-link-preview/health.svg)](https://phpackages.com/packages/marcelklehr-link-preview) ``` ### Alternatives [dusterio/link-preview Link preview generation for PHP with Laravel support 126326.6k3](/packages/dusterio-link-preview)[laracrafts/laravel-url-shortener Powerful URL shortening tools in Laravel 97110.7k](/packages/laracrafts-laravel-url-shortener)[gallib/laravel-short-url A Laravel package to shorten urls 16516.4k](/packages/gallib-laravel-short-url)[madeitbelgium/wappalyzer PHP Library that uncovers the technologies used on websites. 1417.5k](/packages/madeitbelgium-wappalyzer)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 245.2k](/packages/aedart-athenaeum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)