JUImage
v5.19
Juimage-库的库,用于用支持WebP和AVIF的拇指。
为Joomla创建大拇指!扩展或独立使用。
composer require joomla-ua/juimage
然后,您可以稍后使用Composer更新:
composer update
安装后,您需要需要作曲家的自动加载器:
require_once ( ' vendor/autoload.php ' );
$ config [ ' root_path ' ] = __DIR__ ;
$ config [ ' img_blank ' ] = ' images/logos ' ;
$ juImg = new JUImage Image ( $ config );
$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
' w ' => ' 300 ' ,
' h ' => ' 100 ' ,
' q ' => ' 77 ' ,
' cache ' => ' img '
]);
echo ' <img src=" ' . $ thumb . ' " alt="Apple" width="300" height="100"> ' ;| 全局选项 | 描述 |
|---|---|
$root_path | 您的网站的根路径。默认定义JPATH_BASE |
$img_blank | 通往默认图像的路径。例如,如果找不到图像,请显示默认图像noimage.png 。如果找不到图像或破坏图像,请还使用option error_image (转到选项) |
使用Joomla安装扩展库(lib_juimage_v3.xzzip)!扩展管理器。
用于扩展的代码。
JLoader:: register ( ' JUImage ' , JPATH_LIBRARIES . ' /juimage/JUImage.php ' );
$ juImg = new JUImage ();
$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
' w ' => ' 300 ' ,
' h ' => ' 100 ' ,
' q ' => ' 77 ' ,
' cache ' => ' img '
]);
echo ' <img src=" ' . $ thumb . ' " alt="Apple" width="300"> ' ;或者
require_once ( JPATH_SITE . ' /libraries/juimage/vendor/autoload.php ' );
$ juImg = new JUImage Image ();
$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
' w ' => ' 300 ' ,
' h ' => ' 100 ' ,
' q ' => ' 77 ' ,
' cache ' => ' img '
]);
echo ' <img src=" ' . $ thumb . ' " alt="Apple" width="300"> ' ; <?php
$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
' w ' => ' 300 ' ,
' h ' => ' 100 ' ,
' q ' => ' 95 ' ,
' webp ' => true
]);
?>
<picture>
<source srcset=" <?php echo $ thumb -> webp ; ?> " type="image/webp">
<img src=" <?php echo $ thumb -> img ; ?> " alt="Apple" width="300" height="100">
</picture>使用GD2 lib进行WebP拇指:
<?php
$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
' w ' => ' 300 ' ,
' h ' => ' 100 ' ,
' q ' => ' 95 ' ,
' webp ' => true ,
' imagemagick ' => false
]);
?>| WebP命令 | 类型 | 默认 | 描述 |
|---|---|---|---|
| WebP | 布尔 | 错误的 | 如果true添加支持WebP映像。对于此选项,请使用标签<picture> ,请参见示例。 |
AVIF图像格式(需要PHP 8.1.0)
<?php
$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
' w ' => ' 300 ' ,
' h ' => ' 100 ' ,
' q ' => ' 95 ' ,
' avif ' => true
]);
?>
<picture>
<source srcset=" <?php echo $ thumb -> avif ; ?> " type="image/avif">
<img src=" <?php echo $ thumb -> img ; ?> " alt="Apple" width="300" height="100">
</picture>| WebP命令 | 类型 | 默认 | 描述 |
|---|---|---|---|
| 阿维夫 | 布尔 | 错误的 | 如果true添加支持WebP映像。对于此选项,请使用标签<picture> 。 AVIF图像格式(需要PHP 8.1.0) |
<?php
$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
' w ' => ' 300 ' ,
' h ' => ' 100 ' ,
' q ' => ' 95 ' ,
' avif ' => true ,
' webp ' => true
]);
?>
<picture>
<source srcset=" <?php echo $ thumb -> avif ; ?> " type="image/avif">
<source srcset=" <?php echo $ thumb -> webp ; ?> " type="image/webp">
<img src=" <?php echo $ thumb -> img ; ?> " alt="Apple" width="300" height="100">
</picture>YouTube:
$ thumb = $ juImg -> render ( ' https://www.youtube.com/watch?v=xxxxxxxxxxx ' , [
' w ' => ' 300 ' ,
' h ' => ' 100 '
]);Vimeo:
$ thumb = $ juImg -> render ( ' https://vimeo.com/xxxxxxxxx ' , [
' w ' => ' 300 ' ,
' h ' => ' 100 '
]); <?php
$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
' w ' => ' 300 '
]);
// Image size for thumb
$ size = $ juImg -> size ( $ thumb );
echo ' <img src=" ' . $ thumb . ' " alt="Apple" width=" ' . $ size -> width . ' " height=" ' . $ size -> height . ' "> ' ; 将选项添加到此数组:
[
' w ' => ' 300 ' ,
' h ' => ' 100 ' ,
' q ' => ' 77 ' ,
' cache ' => ' img '
]| 命令 | 描述 |
|---|---|
| 缓存 | 缩略图的文件夹 |
| error_image | 默认图像的路径如果未找到或破坏图像 |
| w | 像素的最大输出缩略图宽度 |
| h | 像素的最大输出缩略图高度 |
| WP | 肖像图像的最大宽度 |
| 惠普 | 肖像图像的最大高度 |
| WL | 景观图像的最大宽度 |
| HL | 景观图像的最大高度 |
| WS | 正方形图像的最大宽度 |
| HS | 平方图像的最大高度 |
| f | 输出图像格式(“ jpeg”,“ png”,“ gif”,“ webp”或“ avif”) |
| 问 | JPEG压缩(1 =最差,95 =最佳,75 =默认值) |
| sx | 源矩形的左侧(默认为0)(值0 <sx <1表示百分比) |
| sy | 源矩形的顶部(默认为0)(值0 <sy <1表示百分比) |
| SW | 源矩形的宽度(默认fullWidth)(值0 <sw <1表示百分比) |
| sh | 源矩形的高度(默认fullheight)(值0 <sh <1表示百分比) |
| ZC | Zoom-crop。将自动编写较大的尺寸,以使图像填充较小的维度(需要“ W”和“ H”,覆盖“ IAR”,“ far”)。将“ 1”或“ C”设置为“缩放”到中心,或设置为“ t”,“ b”,“ l”,“ r”,“ tl”,“ tl”,“ tr”,“ tr”,“ bl”,“ br”,“ br”,倾斜到顶/左/底部/右图(Reques fulsemagick for imagemagick for其他值以外的值或“ 1”)或“ 1”)) |
| BG | 背景六角形(默认FFFFFF) |
| 公元前 | 边界六角形(默认000000) |
| XTO | 仅EXIF缩略图 - 设置仅提取EXIF缩略图而不进行任何其他处理 |
| RA | 按角度旋转:以逆时针为正的旋转角度,负,顺时针方向 |
| ar | 自动旋转:设置为“ X”以使用相机存储的EXIF方向。也可以将景观的“ L”或“ L”设置为“ L”或“ P”或“ P”。 “ L”和“ P”顺时针旋转图像,“ L”和“ P”逆时针旋转图像。 |
| SFN | 源框架编号 - 使用此帧/页码进行多帧/多页源图像(GIF,TIFF等) |
| aoe | 输出允许放大-1 = ON,0 = OFF。 “ FAR”和“ IAR”都覆盖了这一点,并且允许输出大于输入) |
| IAR | 忽略纵横比 - 禁用比例调整大小和拉伸图像以适合“ H”和“ W”(必须设置两者)。 (1 = on,0 = off)(覆盖“远”) |
| 远的 | 力纵横比 - 将以“ W”和“ H”指定的大小创建图像(必须设置这两个图像)。对齐:l =左,r =右,t = top,b =底部,c =中心。如果图像是景观或肖像,则BL,BR,TL,TR使用适当的方向。 |
| DPI | 每英寸点 - 输入DPI设置从矢量图像格式导入时,例如PDF,WMF等 |
| SIA | 将图像另存为 - 默认文件名以将生成的图像保存为。指定基本文件名,将自动添加扩展名(例如:“ .png”) |
| 麦克斯 | 最大字节尺寸 - 输出质量是自动设置的,可以将缩略图拟合到“ maxb”字节中(针对JPEG调整了压缩质量,对PNG和GIF调整了位深度) |
GNU通用公共许可证版本3或更高版本;请参阅许可证
Juimage基于Phpthumb()类(James Heinrich)和快速图书馆图书馆(Marc Alexander)。
感谢JetBrains在其免费的开源许可计划中赞助一些所有产品包来支持该项目。