spescina/imgproxy

An image proxy for Laravel

Tuesday, October 14, 2014
by simonpex
Repository
2 Watchers
18 Stars
1,109 Installations

PHP
0 Dependents
1 Suggesters
4 Forks
4 Open issues
15 Versions
2 % Grown

The README.md

, _(*1)

ImageProxy

Laravel 4 package for image cropping and resizing on the fly. It uses Timthumb under the hood., _(*2)

Install && Usage

Add in composer.json, _(*3)

"require": {
    "spescina/imgproxy": "2.x"
}

Run composer update, _(*4)

Add the service provider in the app/config/app.php file, _(*5)

"Spescina\Imgproxy\ImgproxyServiceProvider"

Publish the package assets running php artisan asset:publish spescina/imgproxy, _(*6)

Publish the package config running php artisan config:publish spescina/imgproxy, _(*7)

ImageProxy is configured to use Apache by default. If you are using nginx, add the following to your site configuration file:, _(*8)

rewrite ^/packages/spescina/imgproxy/([0-9]+)/([0-9]+)/([0-9]+)/([0-9]+)/(.*) /packages/spescina/imgproxy/timthumb.php?w=$1&h=$2&zc=$3&q=$4&src=$5;

Use the package facade to generate the resource url, _(*9)

ImgProxy::link("path/to/image.jpg", 100, 80)

This will generate a link like this, _(*10)

http://www.yourdomain.com/packages/spescina/imgproxy/100/80/path/to/image.jpg

that generates an image with dimensions 100 x 80 using the original image.jpg stored in the public/path/to folder., _(*11)

Parameters

The link function accepts 5 paramaters * image path * width * height * quality - optional [0..100] - Default: 90 * zoom/crop - optional [0,1,2,3] - Default: 1, _(*12)

Zoom/Crop

These are the supported values * 0 - Resize to Fit specified dimensions (no cropping)
* 1 - Crop and resize to best fit the dimensions (default) * 2 - Resize proportionally to fit entire image into specified dimensions, and add borders if required * 3 - Resize proportionally adjusting size of scaled image so there are no borders gaps, _(*13)

Config

Package config

After publishing the package config file it's possible to change the package behaviour in the app/config/packages/spescina/imgproxy/config.php file., _(*14)

These are the current options: * rewrite - Default: true - If false querystring uri are generated instead of pretty ones, _(*15)

Timthumb config

It's possible to edit timthumb config in the public/packages/spescina/imgproxy/timthumb-config.php file., _(*16)

These, at the moment, are the default values, _(*17)

define ("DEBUG_ON", false);

define ("DEBUG_LEVEL", 3);

define ("FILE_CACHE_MAX_FILE_AGE", 86400);

define ("FILE_CACHE_SUFFIX", ".imgproxy.cache");

define ("FILE_CACHE_PREFIX", "");

define ("FILE_CACHE_DIRECTORY", "../../../../app/storage/cache/imgproxy");

define ("NOT_FOUND_IMAGE", "./nophoto.gif");

define ("ERROR_IMAGE", "./nophoto.gif");

define ("PNG_IS_TRANSPARENT", FALSE);

define ("DEFAULT_Q", 90);

Full nginx example for Laravel Forge

server {
    rewrite_log on;

    listen 80;
    server_name my_site.com;
    root /home/forge/my_site.com/public;

    auth_basic "Restricted";
    auth_basic_user_file /home/forge/my_site.com/public/.htpasswd;

    # FORGE SSL (DO NOT REMOVE!)
    # ssl on;
    # ssl_certificate;
    # ssl_certificate_key;

    index index.html index.htm index.php;

    charset utf-8;

    location / {
        rewrite ^/packages/spescina/imgproxy/([0-9]+)/([0-9]+)/([0-9]+)/([0-9]+)/(.*) /packages/spescina/imgproxy/timthumb.php?w=$1&h=$2&zc=$3&q=$4&src=$5;
        try_files $uri $uri/ /index.php?$query_string;
    }

    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }

    access_log off;
    error_log  /var/log/nginx/my_site.com-error.log error;

    error_page 404 /index.php;

    location ~ \.php$ {
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass unix:/var/run/php5-fpm.sock;
        fastcgi_index index.php;
        include fastcgi_params;
    }

    location ~ /\.ht {
        deny all;
    }
}

The Versions

14/10 2014

dev-master

9999999-dev

An image proxy for Laravel

library imgproxy

An image proxy for Laravel

spescina/imgproxy

The README.md

ImageProxy

Install && Usage

Parameters

Zoom/Crop

Config

Package config

Timthumb config

Full nginx example for Laravel Forge

The Versions

dev-master

The Requires

The Development Requires

by Simone Pescina

2.1.6

The Requires

The Development Requires

by Simone Pescina

dev-develop

The Requires

The Development Requires

by Simone Pescina

2.1.5

The Requires

The Development Requires

by Simone Pescina

2.1.4

The Requires

The Development Requires

by Simone Pescina

2.1.3

The Requires

The Development Requires

by Simone Pescina

2.1.2

The Requires

The Development Requires

by Simone Pescina

2.1.1

The Requires

The Development Requires

by Simone Pescina

2.1.0

The Requires

The Development Requires

by Simone Pescina

2.0.2

The Requires

The Development Requires

by Simone Pescina

2.0.1

The Requires

The Development Requires

by Simone Pescina

2.0.0

The Requires

The Development Requires

by Simone Pescina

1.0.2

The Requires

The Development Requires

by Simone Pescina

1.0.0

The Requires

by Simone Pescina

1.0.1

The Requires

by Simone Pescina