├── .gitignore
├── composer.json
├── readme.md
└── src
    └── Beije
        └── CameraRaw
            ├── Bridge
                └── Laravel
                │   ├── CameraRawFacade.php
                │   └── CameraRawServiceProvider.php
            └── CameraRaw.php


/.gitignore:
--------------------------------------------------------------------------------
1 | /vendor/
2 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "vkollin/php-camera-raw",
 3 |     "type": "library",
 4 |     "description": "A class that can fetch preview images from camera raw files.",
 5 |     "keywords": [
 6 |         "image",
 7 |         "raw",
 8 |         "laravel"
 9 |     ],
10 |     "homepage": "https://github.com/beije/php-camera-raw",
11 |     "minimum-stability": "stable",
12 |     "authors": [
13 |         {
14 |             "name": "Benjamin Horn",
15 |             "email": "beije@benjaminhorn.se",
16 |             "homepage": "http://benjaminhorn.io",
17 |             "role": "Developer"
18 |         }
19 |     ],
20 |     "autoload": {
21 |         "psr-4": {
22 |           "Beije\\CameraRaw\\": "src/Beije/CameraRaw"
23 |         }
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/readme.md:
--------------------------------------------------------------------------------
 1 | # Camera Raw parsing with php
 2 | 
 3 | A class that can fetch preview images from camera raw files.
 4 | 
 5 | In order to use this class you'll need a few php mods and 
 6 | some other software installed on your server.
 7 | 
 8 | - imagemagick (Manage images)
 9 | - ufraw (Reading and converting raw files)
10 | - exiv2 (Extracting previews from raw files)
11 | 
12 | [Click here for more information and documentation.](http://benjaminhorn.io/code/extracting-thumbnails-from-camera-raw-files-cr2-and-nef-with-php/)


--------------------------------------------------------------------------------
/src/Beije/CameraRaw/Bridge/Laravel/CameraRawFacade.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Beije\CameraRaw\Bridge\Laravel;
 4 | 
 5 | use Illuminate\Support\Facades\Facade;
 6 | 
 7 | class CameraRawFacade extends Facade
 8 | {
 9 |     /**
10 |      * Get the registered name of the component.
11 |      *
12 |      * @return string
13 |      *
14 |      * @codeCoverageIgnore
15 |      */
16 |     protected static function getFacadeAccessor()
17 |     {
18 |         return 'cameraraw';
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Beije/CameraRaw/Bridge/Laravel/CameraRawServiceProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Beije\CameraRaw\Bridge\Laravel;
 4 | 
 5 | use Beije\CameraRaw\CameraRaw;
 6 | use Illuminate\Support\ServiceProvider as LaravelServiceProvider;
 7 | 
 8 | class CameraRawServiceProvider extends LaravelServiceProvider
 9 | {
10 |     /**
11 |      * Indicates if loading of the provider is deferred.
12 |      *
13 |      * @var bool
14 |      */
15 |     protected $defer = true;
16 | 
17 |     /**
18 |      * Register the service provider.
19 |      */
20 |     public function register()
21 |     {
22 |         $this->app->bindShared('cameraraw', function () {
23 |             return new CameraRaw();
24 |         });
25 |     }
26 | 
27 |     /**
28 |      * Get the services provided by the provider.
29 |      *
30 |      * @return string[]
31 |      */
32 |     public function provides()
33 |     {
34 |         return array('cameraraw');
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Beije/CameraRaw/CameraRaw.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | /**
  4 |  * A class that can fetch preview images from camera raw files.
  5 |  *
  6 |  * In order to use this class you'll need a few php mods and
  7 |  * some other software installed on your server.
  8 |  *
  9 |  * - imagemagick (Manage images)
 10 |  * - ufraw (Reading and converting raw files)
 11 |  * - exiv2 (Extracting previews from raw files)
 12 |  */
 13 | namespace Beije\CameraRaw;
 14 | 
 15 | class CameraRaw
 16 | {
 17 |     /**
 18 |      * @var array an array containing popular raw file format extensions
 19 |      */
 20 |     private static $rawExtensions = array('ari','arw','bay','crw','cr2','cap','dcs','dcr','dng','drf','eip','erf','fff','iiq','k25','kdc','mdc','mef','mos','mrw','nef','nrw','obm','orf','pef','ptx','pxn','r3d','raf','raw','rwl','rw2','rwz','sr2','srf','srw', 'x3f');
 21 | 
 22 |     /**
 23 |      * Checks if a file is a raw file based on file extension.
 24 |      *
 25 |      * @param string $filePath the path to the file
 26 |      *
 27 |      * @return bool returns true if the file is a raw type
 28 |      */
 29 |     public static function isRawFile($filePath)
 30 |     {
 31 |         return in_array(strToLower(pathinfo($filePath, PATHINFO_EXTENSION)), self::$rawExtensions);
 32 |     }
 33 | 
 34 |     /**
 35 |      * Fetches all preview types that are embedded in an image.
 36 |      *
 37 |      * @param string $filePath the path to the file
 38 |      *
 39 |      * @return array all the detected previews.
 40 |      */
 41 |     public static function embeddedPreviews($filePath)
 42 |     {
 43 |         if (!file_exists($filePath)) {
 44 |             throw new \InvalidArgumentException('Incorrect filepath given');
 45 |         }
 46 | 
 47 |         $previews = array();
 48 |         exec('exiv2 -pp "'.$filePath.'"', $previews);
 49 | 
 50 |         return $previews;
 51 |     }
 52 | 
 53 |     /**
 54 |      * Generates a new jpg image with new sizes from an already existing file.
 55 |      * (This will also work on raw files, but it will be exceptionally
 56 |      * slower than extracting the preview).
 57 |      *
 58 |      * @param string $sourceFilePath the path to the original file
 59 |      * @param string $targetFilePath the path to the target file
 60 |      * @param int    $width          the max width
 61 |      * @param int    $height         the max height of the image
 62 |      * @param int    $quality        the quality of the new image (0-100)
 63 |      *
 64 |      * @throws \InvalidArgumentException
 65 |      * @throws \ImagickException
 66 |      */
 67 |     public static function generateImage($sourceFilePath, $targetFilePath, $width, $height, $quality = 60)
 68 |     {
 69 |         if (!file_exists($sourceFilePath)) {
 70 |             throw new \InvalidArgumentException('Incorrect filepath given');
 71 |         }
 72 | 
 73 |         $im = new \Imagick($sourceFilePath);
 74 |         $im->setImageFormat('jpg');
 75 |         $im->setImageCompressionQuality($quality);
 76 |         $im->stripImage();
 77 |         $im->thumbnailImage($width, $height, true);
 78 |         $im->writeImage($targetFilePath);
 79 |         $im->clear();
 80 |         $im->destroy();
 81 |     }
 82 | 
 83 |     /**
 84 |      * Extracts a preview image from an image and saves the
 85 |      * image to the designated path.
 86 |      *
 87 |      * @param string $sourceFilePath the path to the original file
 88 |      * @param string $targetFilePath the path to the new file
 89 |      * @param int    $previewNumber  which preview (defaults to the highest preview)
 90 |      *
 91 |      * @throws \InvalidArgumentException
 92 |      * @throws \Exception
 93 |      */
 94 |     public static function extractPreview($sourceFilePath, $targetFilePath, $previewNumber = null)
 95 |     {
 96 |         // check that the source file exists.
 97 |         if (!file_exists($sourceFilePath)) {
 98 |             throw new \InvalidArgumentException('Incorrect source filepath given '.$sourceFilePath);
 99 |         }
100 | 
101 |         // fetch the all the preview images (and verify that there indeed exit previews)
102 |         $numberOfPreviews = self::embeddedPreviews($sourceFilePath);
103 |         if (count($numberOfPreviews) == 0) {
104 |             throw new \Exception('No embedded previews detected');
105 |         }
106 | 
107 |         // default to the last preview
108 |         if (is_null($previewNumber)) {
109 |             $previewNumber = count($numberOfPreviews);
110 |         }
111 | 
112 |         $previewNumber = intval($previewNumber);
113 |         $filename = pathinfo($sourceFilePath, PATHINFO_FILENAME);
114 |         $return = array();
115 | 
116 |         // generate the preview with exiv2, save it to the temp directory
117 |         exec('exiv2 -ep'.$previewNumber.' -l '.sys_get_temp_dir().' "'.$sourceFilePath.'"', $return);
118 |         $previewFilePath = sys_get_temp_dir().DIRECTORY_SEPARATOR.$filename.'-preview'.$previewNumber.'.jpg';
119 | 
120 |         // check that the preview got saved correctly
121 |         if (!file_exists($previewFilePath)) {
122 |             throw new \Exception('No preview file.');
123 |         }
124 | 
125 |         // copy the preview to the target path and remove the original one in temp
126 |         copy($previewFilePath, $targetFilePath);
127 |         unlink($previewFilePath);
128 |     }
129 | }
130 | 


--------------------------------------------------------------------------------