aliakbarrashidi / instagramdownload

Instagram image and video downloader with URL validation and cURL integration

InstagramDownload - Instagram photo and Video Downloader

Modernized version of your favorite Instagram Photo and video download helper class. If you are looking for the legacy version, see here. You can also try the 2.x branch, which supports PHP 7.1.

I wrote this class mainly for my [online Instagram photo, video and IGTV downloader] 1, but I thought share this piece for your own extensions.

• Validates Instagram URL (domain validation, URL path validation).
• Uses OG properties to detect the image and video URL.
• Supports Instagram photos, videos, and Instagram TV videos
• Verbose error reporting with proper exceptions.
• Full unit tests
• No dependencies other than PHP curl extension (which is most likely enabled by already)

Requirements

• PHP 7.2
• Curl

Thanks to:

• MetaData - Meta data parsing regex and curl class.

Installation

With composer Install the library by running the following in your project.

composer require ayesh/instagram-download

Without composer Download the zip file from Github, and configure your autoload handler to autoload PSR-4 Ayesh\InstagramDownload namespace from the downloaded contents src directory.

You could also manually require the file. Requires a certain amount of guilty feeling because it's 2017 and you are not using a decent autoload mechanism.

require_once 'src/InstagramDownload.php'

Usage

<?php
use Ayesh\InstagramDownload\InstagramDownload;
$url = 'http://instagram.com/p/tmwAlCGygb/';

try {
  $client = new InstagramDownload($url);
  $url = $client->getDownloadUrl(); // Returns the download URL.
  $type = $client->getType(); // Returns "image" or "video" depending on the media type.
}
catch (\InvalidArgumentException $exception) {
  /*
   * \InvalidArgumentException exceptions will be thrown if there is a validation 
   * error in the URL. You might want to break the code flow and report the error 
   * to your form handler at this point.
   */
  $error = $exception->getMessage();
}
catch (\RuntimeException $exception) {
  /*
   * \RuntimeException exceptions will be thrown if the URL could not be 
   * fetched, parsed, or a media could not be extracted from the URL. 
   */
  $error = $exception->getMessage();
}