Skip to content

PHP ultra-fast library to allow accessing the excellent ExifTool (http://www.sno.phy.queensu.ca/~phil/exiftool/) metadata manipulation tool on single files or on batches.

Notifications You must be signed in to change notification settings

tsmgeek/ExifTool_PHP_Stayopen

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 Commits
 
 
 
 
 
 

Repository files navigation

ExifTool_PHP_Stayopen

Ive created a script that can be used to run ExifTool in StayOpen mode within PHP. The script can be inited as a singleton or instance. Ive also supplied two additional scripts that wrap the class ready for use with gearman for scaleout. The class does not apply any logic to the parameters supplied to ExifTool, what you push though gets passed though and the result is then returned. The class detects if ExifTool has died and restarts it on the next call.

It still has some work to do and cleaning up but seems to work well in my environment and scales out quite nicely. Originally I was using PHP streams but this proved to be a problem so instead using fgets to parse the return. Note that script is hard coded to work with 9.03+ of ExifTool only because this is all I have been testing against since.

Let me know what you think or any changes to make it better.

Phil Harvey's Exiftool - http://www.sno.phy.queensu.ca/~phil/exiftool/

Phil Harvey's Exiftool (Forum Dev Post) - http://u88.n24.queensu.ca/exiftool/forum/index.php/topic,5381.0.html

Performance tests

These figures are to be taken as a guide of performance increase possible with supplied scripts but will vary depending on your hardware setup and arguments supplied to ExifTool (test system was running on ESXi/Opteron 2435/4vCPU/2G)

100 iterations fetching metadata from a JPEG (-use MWG -g -j -all:all)
1 GM Instance - 1.3s
2 GM Instances - 0.9s
3 GM Instances - 0.7s
4 GM Instances - 0.6s

300 iterations with 4 GM Instances - 1.6s
100 iterations 3 files on each iteration with 4 GM Instances - 1.4s
50 iterations 6 files on each iteration with 4 GM Instances - 1.1s
100 iterations 10 files on each iteration with 4 GM Instances - 3.1s

Usage

Below is a basic example on how to use this class. Put all your commands in an array and push it into the stack using the $exif->add() function, you can add multiple jobs to process before calling fetch()/fetchAll().

getInstance() setup class as a singleton
setExifToolPath($path) set/change the path of ExifTool if not supplied at start
setIdleTimeout($timeout) idle seconds until ExifTool process is terminated
setProcessTimeout($timeout) total ExifTool running seconds until process is terminated
close() terminate ExifTool background process
start() start ExifTool background process
test() to check if ExifTool is running.
clear() clear the stack
fetch() will return one processed item off the stack at a time.
fetchAll() will return a single array with all items in the stack processed.
fetchDecoded($assoc) will return one processed item off the stack at a time with JSON output decoded.
fetchAllDecoded($assoc) will return a single array with all items in the stack processed and JSON output decoded.
fetchCallback($callback) will return one processed item via user callback off the stack at a time .
fetchAllCallback($callback) will return a single array with all items in the stack processed after processing via user callback.
getError($id) will return FALSE or STDERR output if there was an error, pass index if fetchAll() was used
getErrorStr($id) will return STDERR output, pass index if fetchAll() was used
getSummary(msg) will return summary value from msg passed which are defined as const's

As you fetch items they are taken off the stack.

Examples

Simple request to get all image metadata

$data=array('-*:*','test1.jpg');
$exif = \Exiftool\ExifToolBatch::getInstance("/path/to/exiftool");
$exif->add($data);
$result=$exif->fetchAll();

About

PHP ultra-fast library to allow accessing the excellent ExifTool (http://www.sno.phy.queensu.ca/~phil/exiftool/) metadata manipulation tool on single files or on batches.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages