[함수] 섬네일 클래스
2011. 7. 17. 09:47ㆍ컴퓨터_computer/PHP, HTML
가급적 PHP 5.3 이상 버전에서 가능할걸로 예상하고, 이하 버전에서는 테스트는 못해봤습니다.
주요기능
- 섬네일 width, height 지정 가능 (둘 중 하나만 지정할 경우 해당 이미지 비율에 맞춰 섬네일 크기 설정)
- 축소 방법 설정 (섬네일 안에 이미지 모두 보이게, 섬네일 크기에 꽉차게 설정 가능)
- 출력 섬네일 파일형식 설정 가능 (GIF, JPG, PNG)
- 섬네일 처리 전/후 콜백 함수 등록 가능 (콜백함수로 테두리 및 워터마크 등 사용자가 쉽게 추가 가능)
- 섬네일 저장 경로를 쉽게 설정 가능 (키워드 사용으로 섬네일 경로에 이미지 크기나 경로를 쉽게 사용)
사용예
sample.php
<?php
require_once 'Thumbnail.class.php';
$watermark = new ThumbnailWatermark;
$sourcefiles = Array(
'sample_1.jpg',
'sample_2.jpg'
);
Thumbnail::setOption('debug', true);
for ($L1 = 0; $L1 < count($sourcefiles); $L1++)
{
// case 1
// 크기를 120x120 으로 설정하고 크기 안에 이미지가 모두 보이도록 설정
// 워터마크는 사용안함
Thumbnail::create($sourcefiles[$L1],
120, 120,
SCALE_SHOW_ALL,
Array(
'savepath' => '%PATH%%FILENAME%_thumb-case-1.%EXT%'
));
// case 2
// 크기를 120x120 으로 설정하고 크기 안에 이미지가 모두 보이도록 설정
Thumbnail::create($sourcefiles[$L1],
120, 120,
SCALE_SHOW_ALL,
Array(
'preprocess' => Array(&$watermark, 'preprocess'),
'postprocess' => Array(&$watermark, 'postprocess'),
'savepath' => '%PATH%%FILENAME%_thumb-case-2.%EXT%'
));
// case 3
// 크기를 120x120 으로 설정하고 이미지가 크기에 꽉 차도록 설정
Thumbnail::create($sourcefiles[$L1],
120, 120,
SCALE_EXACT_FIT,
Array(
'preprocess' => Array(&$watermark, 'preprocess'),
'postprocess' => Array(&$watermark, 'postprocess'),
'savepath' => '%PATH%%FILENAME%_thumb-case-3.%EXT%'
));
// case 4
// 넓이만 120 픽셀로 고정하고, 기본 옵션을 PNG 파일로 출력하도록 설정
Thumbnail::setOption('export', EXPORT_PNG);
Thumbnail::create($sourcefiles[$L1],
120, null,
null,
Array(
'preprocess' => Array(&$watermark, 'preprocess'),
'postprocess' => Array(&$watermark, 'postprocess'),
'savepath' => '%PATH%%FILENAME%_thumb-case-4.%EXT%'
));
Thumbnail::setOption('export', EXPORT_JPG);
}
Thumbnail.class.php
부족하거나 추가할 부분 있으면 직접 수정하셔도 무방합니다.
<?php
/**
* 섬네일 생성 클래스
* PHPSchool 괴부기님의 코드를 원본으로 상당부분 수정하였습니다.
*
* @class Thumbnail
* @author 괴부기, KAi
* @version 0.2 (2011-06-21)
* @see http://phpschool.com/gnuboard4/bbs/board.php?bo_table=tipntech&wr_id=46878
* @modified KAi (2011-06-21)
*
*
* - 주요기능
* - 섬네일 width, height 지정 가능 (둘 중 하나만 지정할 경우 해당 이미지 비율에 맞춰 섬네일 크기 설정)
* - 축소 방법 설정 (섬네일 안에 이미지 모두 보이게, 섬네일 크기에 꽉차게 설정 가능)
* - 출력 섬네일 파일형식 설정 가능 (GIF, JPG, PNG)
* - 섬네일 처리 전/후 콜백 함수 등록 가능 (콜백함수로 테두리 및 워터마크 등 사용자가 쉽게 추가 가능)
* - 섬네일 저장 경로를 쉽게 설정 가능 (키워드 사용으로 섬네일 경로에 이미지 크기나 경로를 쉽게 사용)
*/
define('SCALE_EXACT_FIT', 'exactfit');
define('SCALE_SHOW_ALL', 'showall');
define('EXPORT_JPG', 'jpg');
define('EXPORT_GIF', 'gif');
define('EXPORT_PNG', 'png');
class Thumbnail
{
// {{{ Variables
// 기본 옵션 정보
private static $_TdefaultOptions = Array(
'debug' => false,
'export' => 'jpg',
'preprocess' => null,
'postprocess' => null,
'savepath' => '%PATH%%FILENAME%_thumb.%EXT%'
);
// }}}
// {{{ Functions
/**
* 섬네일 이미지 생성
*
* @param String $filepath 원본 파일이 있는 경로를 지정한다.
* @param Number $width (optional) 섬네일 넓이. width와 height 둘 중 하나는 반드시 지정되어야
* 하며,하나가 null 인 경우 다른 값(width 또는 height)을 기준으로 이미지의 비율에 맞게 크기가 설정된다.
* @param Number $height (optional) 섬네일 높이.
* @param String $scale (optional) 축소 방식. 만약, width 또는 height 값 중 하나라도 지정이 안된
* 경우 scale 은 자동적으로 SCALE_SHOW_ALL이 되며 이미지 전체가 표시 된다.
* SCALE_EXACT_FIT, SCALE_SHOW_ALL 둘 중 하나를 지정가능 하고, width 및 height 값이 지정된 경우 해당 방식에
* 맞게 축소가 되는데, SCALE_EXACT_FIT 의 경우 지정된 섬네일 크기에 이미지가 꽉차게 축소된다.
* SCALE_SHOW_ALL 의 경우 섬네일 크기 안에 원본 이미지가 모두 보이도록 축소된다. 이 경우 섬네일에 여백이
* 생길 수 있다. 기본적으로 여백의 색은 검은색이지만, preprocess 함수를 지정하여 다른색으로 변경 가능하다.
* @param Array $options (optional) 기타 옵션. 기타 옵션에서는 출력될 섬네일 파일 형식과, 섬네일
* 전/후 처리 콜백 함수, 섬네일 저장 경로를 설정 가능하다.
*
* - 옵션 항목
* $options = Array(
* 'export' => 'jpg',
* 'preprocess' => Array(&$class, 'preprocess'),
* 'postprocess' => 'postprocess',
* 'savepath' => '%PATH%%FILENAME%_thumb.%EXT%'
* );
*
* export 에서는 gif, jpg, png 를 선택할 수 있다. (기본값은 jpg)
* preprocess, postprocess 에서는 섬네일 생성시 이미지 축소 전/후에 콜백함수를 호출하여 배경 및 워터마크를
* 넣도록 할 수 있다. 설정방법은 여타 PHP 함수 호출과 마찬가지로, 클래스 메소드를 호출할 경우 preprocess
* 내용 처럼 배열로 클래스 객체와 메소드를 넘겨주면되고, 일반 함수를 호출할 경우 postprocess 처럼 함수명을
* 적으면 된다.
* savepath 는 섬네일이 저장된 경로를 설정하는 것으로 미리 설정된 키워드를 통해 원본이미지 경로 정보를 이용
* 할 수 있다. 기본값은 원본이미지 경로 뒤에 _thumb 이 붙는것으로 원본이미지와 같은 폴더에 저장이 된다.
* 다른 폴더에 저장을 하려면 %PATH% 키워드 앞이나 뒤에 다른 경로를 적거나 %PATH% 대신 다른 경로를 적으면 되며
* 만약 해당 경로에 폴더가 없다면 자동으로 생성 된다.
* ※ 중요: savepath 설정할때 %EXT% 와 같은 확장자가 빠지면 확장자 없이 이미지 경로가 생성되기 때문에 문제가
* 될 수 있습니다.
*
* - 설정된 키워드
* %PATH% 원본 이미지 경로
* %FILENAME% 원본 이미지 파일명 (확장자 제외)
* %EXT% 섬네일 출력 형식 확장자 (옵션에서 export 로 설정된 형식의 확장자 사용)
* %THUMB_WIDTH 섬네일 넓이
* %THUMB_HEIGHT 섬네일 높이
* %IMAGE_WIDTH 원본 이미지 넓이
* %IMAGE_HEIGHT 원본 이미지 높이
*
* @return String 섬네일 경로
*/
public static function create($filepath, $width = null, $height = null, $scale = 'exactfit', $options = null)
{
// 원본 이미지가 없는 경우
if ( ! file_exists($filepath))
Thumbnail::raiseError('#Error: Thumbnail::create() : File not found or permission error.'.' at '. __LINE__);
// 섬네일 크기가 잘못 지정된 경우
if ($width <= 1 && $height <= 1)
Thumbnail::raiseError('#Error: Thumbnail::create() : Invalid thumbnail size.'.' at '. __LINE__);
// 스케일 지정이 안되어 있거나 틀릴 경우 기본 SCALE_SHOW_ALL 으로 지정
if ( ! $scale || ($scale != SCALE_EXACT_FIT && $scale != SCALE_SHOW_ALL))
$scale = SCALE_SHOW_ALL;
// 기타 옵션
if ($options)
$options = array_merge(Thumbnail::$_TdefaultOptions, $options);
// 옵션 중 출력 이미지 형식이 잘못 지정된 경우
if ( ! in_array($options['export'], Array('jpg', 'gif', 'png')))
Thumbnail::raiseError('#Error: Thumbnail::create() : Invalid export format.'.' at '. __LINE__);
// 이미지 타입이 지원되지 않는 경우
// 1 = GIF, 2 = JPEG
$type = getimagesize($filepath);
if (($type[2] < 1 || $type[2] > 2) ||
($type[2] == 1 && ! function_exists('imagegif')) ||
($type[2] == 2 && ! function_exists('imagejpeg')))
{
Thumbnail::raiseError('#Error: Thumbnail::create() : Filetype not supported. Thumbnail not created.'.' at '. __LINE__);
}
// 원본 이미지로부터 Image 객체 생성
switch ($type[2])
{
case 1: $image = imagecreatefromgif($filepath); break;
case 2: $image = imagecreatefromjpeg($filepath); break;
}
// AntiAlias
if (function_exists('imageantialias'))
imageantialias($image, TRUE);
// 이미지 크기 설정
$image_attr = getimagesize($filepath);
$image_width = $image_attr[0];
$image_height = $image_attr[1];
if ($width > 0 && $height > 0)
{
// 섬네일 크기 안에 모두 표시
// 이미지의 가장 큰 면을 기준으로 지정
switch ($scale)
{
case SCALE_SHOW_ALL: $side = ($image_width >= $image_height) ? 'width' : 'height'; break;
case SCALE_EXACT_FIT:
default: $side = ($image_width / $width <= $image_height / $height) ? 'width' : 'height'; break;
}
$thumb_x = $thumb_y = 0;
if ($side == 'width')
{
$ratio = $image_width / $width;
$thumb_width = $width;
$thumb_height = floor($image_height / $ratio);
$thumb_y = round(($height - $thumb_height) / 2);
}
else
{
$ratio = $image_height / $height;
$thumb_width = floor($image_width / $ratio);
$thumb_height = $height;
$thumb_x = round(($width - $thumb_width) / 2);
}
}
else
{
// width 또는 height 크기가 지정되지 않았을 경우,
// 지정된 섬네일 크기 비율에 맞게 다른 면의 크기를 맞춤
$thumb_x = $thumb_y = 0;
if ( ! $width)
{
$thumb_width = $width = intval($image_width / ($image_height / $height));
$thumb_height = $height;
}
elseif ( ! $height)
{
$thumb_width = $width;
$thumb_height = $height = intval($image_height / ($image_width / $width));
}
}
// 섬네일 객체 생성
$thumbnail = imagecreatetruecolor($width, $height);
if ($options['preprocess'])
call_user_func($options['preprocess'], &$thumbnail, $width, $height, $thumb_width, $thumb_height);
@imagecopyresampled($thumbnail, $image, $thumb_x, $thumb_y, 0, 0, $thumb_width, $thumb_height, $image_width, $image_height);
if ($options['postprocess'])
call_user_func($options['postprocess'], &$thumbnail, $width, $height, $thumb_width, $thumb_height);
// 저장할 경로 생성 및 디렉토리 검사
preg_match('@^(.+/)?([^/]+)\.([^.]+)?$@', $filepath, $m);
$savepath = str_replace(Array('%PATH%', '%FILENAME%', '%EXT%', '%THUMB_WIDTH%', '%THUMB_HEIGHT%', '%IMAGE_WIDTH%', '%IMAGE_HEIGHT%'), Array($m[1], $m[2], $options['export'], $width, $height, $image_width, $image_height), $options['savepath']);
Thumbnail::validatePath($savepath);
// 지정된 포멧으로 섬네일이미지 저장
$iserror = false;
switch ($options['export'])
{
case EXPORT_GIF: if ( ! imagegif($thumbnail, $savepath)) $iserror = true; break;
case EXPORT_PNG: if ( ! imagepng($thumbnail, $savepath)) $iserror = true; break;
case EXPORT_JPG:
default: if ( ! imagejpeg($thumbnail, $savepath)) $iserror = true; break;
}
if ($iserror)
Thumbnail::raiseError('#Error: Thumbnail::create() : invalid path or permission error.'.' at '. __LINE__);
elseif (Thumbnail::getOption('debug'))
{
echo '@Debug: Thumbnail::create() - source='. $filepath .', image[width='. $image_width .',height='. $image_height .'], '
.'thumb[width='. $width .',height='. $height .'], scale='. $scale .', scaled[x='. $thumb_x .',y='. $thumb_y
.',width='. $thumb_width .',height='. $thumb_height .']
'."\n";
}
return $savepath;
}// END: function create();
/**
* 기본 옵션 항목을 변경한다.
*
* @param String $name 옵션명
* @param mixed $value 값
* @return void
*/
public static function setOption($name, $value)
{
Thumbnail::$_TdefaultOptions[ $name ] = $value;
}
/**
* 기본 옵션 항목의 값을 반환한다.
*
* @param String $name 옵션명
* @return mixed 값
*/
public static function getOption($name)
{
return Thumbnail::$_TdefaultOptions[ $name ];
}
/**
* 경로가 존재하는지 체크하고 없다면 폴더를 생성
* @param String $path 체크할 경로
* @return Boolean true
*/
public static function validatePath($path)
{
$a = explode('/', dirname($path));
$p = '';
foreach ($a as $v)
{
$p.= $v .'/';
if ( ! is_dir($p))
mkdir($p, 0757);
}
return true;
}// END: function validatePath();
/**
* 오류 처리 핸들러
* @param String $msg 메시지
* @param int $code 오류 코드
* @param int $type 오류 형식
*/
public static function raiseError($msg, $code = 0, $type = 0)
{
die($msg);
}// END: function raiseError();
// }}}
}// END: class Thumbnail
/**
* 샘플 워터마크 클래스
* 이 클래스에서는 이미지 배경색과 테두리 선을 추가하는 예를 보여줍니다.
* preprocess 및 postprocess 함수에서는 Thumbnail 클래스에서 지정한 파라메터를 넘겨 받습니다.
*/
class ThumbnailWatermark
{
/**
* Thumbnail 클래스에서 preprocess 및 postprocess 함수 호출시 넘겨주는 파라메터들
*
* @param Resource $resource GD Image 함수용 섬네일 리소스
* @param Number $thumb_width 섬네일 넓이
* @param Number $thumb_height 섬네일 높이
* @param Number $image_width 섬네일 안에서 축소된 이미지의 넓이
* @param Number $image_height 섬네일 안에서 축소된 이미지의 높이
* ※만약, 섬네일 scale 이 SCALE_SHOW_ALL 일 경우, 섬네일 크기보다 이미지가 작아질 수 있습니다.
* @return void
*/
public function preprocess($resource, $thumb_width, $thumb_height, $image_width, $image_height)
{
// 입력한 색상으로 전체 이미지를 칠한다.
$color = ImageColorAllocate($resource, 240, 240, 240);
ImageFilledRectangle($resource, 0, 0, $thumb_width, $thumb_height, $color);
}
public function postprocess($resource, $thumb_width, $thumb_height, $image_width, $image_height)
{
$color = ImageColorAllocate($resource, 0, 0, 0);
ImageLine($resource, 0, 0, $thumb_width - 1, 0, $color);
ImageLine($resource, $thumb_width - 1, 0, $thumb_width - 1, $thumb_height - 1, $color);
ImageLine($resource, $thumb_width - 1, $thumb_height - 1, 0, $thumb_height - 1, $color);
ImageLine($resource, 0, $thumb_height - 1, 0, 0, $color);
}
}// END: class ThumbnailWatermark
부족하거나 추가할 부분 있으면 직접 수정하셔도 무방합니다.