PHPackages icarexm/image - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. icarexm/image ActiveLibrary[Utility & Helpers](/categories/utility) icarexm/image ============= the new excel extend 00PHP Since May 26Pushed 6y ago1 watchersCompare [ Source](https://github.com/icarexm/php-tools-image)[ Packagist](https://packagist.org/packages/icarexm/image)[ RSS](/packages/icarexm-image/feed)WikiDiscussions master Synced 3w ago READMEChangelogDependenciesVersions (1)Used By (0) 使用`Composer`安装`icarexm`的文件处理类库： ``` composer require icarexm/image:dev-master ``` 生成缩略图 ----- [](#生成缩略图) 下面来看下缩略图操作类的基础方法。 ### 打开图像文件 [](#打开图像文件) 假设当前入口文件目录下面有一个`image.png`文件，如图所示： [![](https://camo.githubusercontent.com/557cebe1b4a426acde6662f9a2ce1b8ec75c6d63ada4a6498852fd814835e95e/68747470733a2f2f6769742e6b616e636c6f75642e636e2f7265706f732f79686c31382f77715f6672616d652f7261772f633962663364363431376338303736663036366335376364313561633536353634383333636164312f696d616765732f6d63646f6e616c645f6c616b652d3030342e6a70673f6163636573732d746f6b656e3d65794a30655841694f694a4b563151694c434a68624763694f694a49557a49314e694a392e65794a6c654841694f6a45314f5441314e4445794f444d73496d6c68644349364d5455354d4451354f4441344d797769636d567762334e706447397965534936496e6c6f62444534584339336356396d636d46745a534973496e567a5a5849694f6e736964584e6c636d3568625755694f694a35614777784f434973496d3568625755694f694a4e636c6c6c4e5467324f534973496d567459576c73496a6f694e5455314f4455784f544241635845755932397449697769644739725a5734694f6949334d5455784e3252694d7a63344d4751794d6a41324d6a63314f546c6c4d6a4d305a5452684f4759354e694973496d463164476876636d6c365a53493665794a7764577873496a7030636e566c4c434a7764584e6f496a7030636e566c4c434a685a4731706269493664484a315a58313966512e5272743941715872626d626548742d45764c73522d313155306c77794867426f46464e3565686b4b706155)](https://camo.githubusercontent.com/557cebe1b4a426acde6662f9a2ce1b8ec75c6d63ada4a6498852fd814835e95e/68747470733a2f2f6769742e6b616e636c6f75642e636e2f7265706f732f79686c31382f77715f6672616d652f7261772f633962663364363431376338303736663036366335376364313561633536353634383333636164312f696d616765732f6d63646f6e616c645f6c616b652d3030342e6a70673f6163636573732d746f6b656e3d65794a30655841694f694a4b563151694c434a68624763694f694a49557a49314e694a392e65794a6c654841694f6a45314f5441314e4445794f444d73496d6c68644349364d5455354d4451354f4441344d797769636d567762334e706447397965534936496e6c6f62444534584339336356396d636d46745a534973496e567a5a5849694f6e736964584e6c636d3568625755694f694a35614777784f434973496d3568625755694f694a4e636c6c6c4e5467324f534973496d567459576c73496a6f694e5455314f4455784f544241635845755932397449697769644739725a5734694f6949334d5455784e3252694d7a63344d4751794d6a41324d6a63314f546c6c4d6a4d305a5452684f4759354e694973496d463164476876636d6c365a53493665794a7764577873496a7030636e566c4c434a7764584e6f496a7030636e566c4c434a685a4731706269493664484a315a58313966512e5272743941715872626d626548742d45764c73522d313155306c77794867426f46464e3565686b4b706155) 使用`open`方法打开图像文件进行相关操作： ``` $thumb = icarexm\image\Thumb::open('image.png', ROOT_PATH); ``` ### 获取图像信息 [](#获取图像信息) 可以获取打开图片的信息，包括图像大小、类型等，例如： ``` $thumb = icarexm\image\Thumb::open('image.png', ROOT_PATH); echo 'width:'.$thumb->getOriginalw().''; echo 'height:'.$thumb->getOriginalh().''; echo 'type:'.$thumb->getSourceType().''; echo 'size:'.$thumb->getOriginalSize().'kb'; echo 'mime:'.$thumb->getSourceMime().''; ``` ### 裁剪图片 [](#裁剪图片) 使用`crop`和`save`方法完成裁剪图片功能。 ``` $thumb = icarexm\image\Thumb::open('image.png', ROOT_PATH); //将图片裁剪为180x180并保存为image.thumb.png $thumb->crop(180, 180)->save(); //获取相对路径 echo $thumb->getSrcname(); //获取完整路径 echo $thumb->getPathname(); ``` 生成的图片如图： [![](https://camo.githubusercontent.com/11a1c8862af750ab9423f6911431ca0a5fc04f43cae180cab2eb3542d97f0dde/68747470733a2f2f6769742e6b616e636c6f75642e636e2f7265706f732f79686c31382f77715f6672616d652f7261772f633962663364363431376338303736663036366335376364313561633536353634383333636164312f696d616765732f6d63646f6e616c645f6c616b652d3030342e7468756d622e6a70673f6163636573732d746f6b656e3d65794a30655841694f694a4b563151694c434a68624763694f694a49557a49314e694a392e65794a6c654841694f6a45314f5441314e4445794f444d73496d6c68644349364d5455354d4451354f4441344d797769636d567762334e706447397965534936496e6c6f62444534584339336356396d636d46745a534973496e567a5a5849694f6e736964584e6c636d3568625755694f694a35614777784f434973496d3568625755694f694a4e636c6c6c4e5467324f534973496d567459576c73496a6f694e5455314f4455784f544241635845755932397449697769644739725a5734694f6949334d5455784e3252694d7a63344d4751794d6a41324d6a63314f546c6c4d6a4d305a5452684f4759354e694973496d463164476876636d6c365a53493665794a7764577873496a7030636e566c4c434a7764584e6f496a7030636e566c4c434a685a4731706269493664484a315a58313966512e5272743941715872626d626548742d45764c73522d313155306c77794867426f46464e3565686b4b706155)](https://camo.githubusercontent.com/11a1c8862af750ab9423f6911431ca0a5fc04f43cae180cab2eb3542d97f0dde/68747470733a2f2f6769742e6b616e636c6f75642e636e2f7265706f732f79686c31382f77715f6672616d652f7261772f633962663364363431376338303736663036366335376364313561633536353634383333636164312f696d616765732f6d63646f6e616c645f6c616b652d3030342e7468756d622e6a70673f6163636573732d746f6b656e3d65794a30655841694f694a4b563151694c434a68624763694f694a49557a49314e694a392e65794a6c654841694f6a45314f5441314e4445794f444d73496d6c68644349364d5455354d4451354f4441344d797769636d567762334e706447397965534936496e6c6f62444534584339336356396d636d46745a534973496e567a5a5849694f6e736964584e6c636d3568625755694f694a35614777784f434973496d3568625755694f694a4e636c6c6c4e5467324f534973496d567459576c73496a6f694e5455314f4455784f544241635845755932397449697769644739725a5734694f6949334d5455784e3252694d7a63344d4751794d6a41324d6a63314f546c6c4d6a4d305a5452684f4759354e694973496d463164476876636d6c365a53493665794a7764577873496a7030636e566c4c434a7764584e6f496a7030636e566c4c434a685a4731706269493664484a315a58313966512e5272743941715872626d626548742d45764c73522d313155306c77794867426f46464e3565686b4b706155) ### 等比例缩放 [](#等比例缩放) 使用`scale`和`save`方法完成图片等比例缩放功能。 ``` $thumb = icarexm\image\Thumb::open('image.png', ROOT_PATH); //将图片以%50等比例缩放并保存为image.thumb.png $thumb->scale(50)->save(); //获取相对路径 echo $thumb->getSrcname(); //获取完整路径 echo $thumb->getPathname(); ``` 生成的图片如图： [![](https://camo.githubusercontent.com/b3aff17c84d93adb32c0bc8df303b6c8eafe9a6bde4cd166098f834e11b1b048/68747470733a2f2f6769742e6b616e636c6f75642e636e2f7265706f732f79686c31382f77715f6672616d652f7261772f633962663364363431376338303736663036366335376364313561633536353634383333636164312f696d616765732f6d63646f6e616c645f6c616b652d3030342e7468756d625f313538373534373837323133372e6a70673f6163636573732d746f6b656e3d65794a30655841694f694a4b563151694c434a68624763694f694a49557a49314e694a392e65794a6c654841694f6a45314f5441314e4445794f444d73496d6c68644349364d5455354d4451354f4441344d797769636d567762334e706447397965534936496e6c6f62444534584339336356396d636d46745a534973496e567a5a5849694f6e736964584e6c636d3568625755694f694a35614777784f434973496d3568625755694f694a4e636c6c6c4e5467324f534973496d567459576c73496a6f694e5455314f4455784f544241635845755932397449697769644739725a5734694f6949334d5455784e3252694d7a63344d4751794d6a41324d6a63314f546c6c4d6a4d305a5452684f4759354e694973496d463164476876636d6c365a53493665794a7764577873496a7030636e566c4c434a7764584e6f496a7030636e566c4c434a685a4731706269493664484a315a58313966512e5272743941715872626d626548742d45764c73522d313155306c77794867426f46464e3565686b4b706155)](https://camo.githubusercontent.com/b3aff17c84d93adb32c0bc8df303b6c8eafe9a6bde4cd166098f834e11b1b048/68747470733a2f2f6769742e6b616e636c6f75642e636e2f7265706f732f79686c31382f77715f6672616d652f7261772f633962663364363431376338303736663036366335376364313561633536353634383333636164312f696d616765732f6d63646f6e616c645f6c616b652d3030342e7468756d625f313538373534373837323133372e6a70673f6163636573732d746f6b656e3d65794a30655841694f694a4b563151694c434a68624763694f694a49557a49314e694a392e65794a6c654841694f6a45314f5441314e4445794f444d73496d6c68644349364d5455354d4451354f4441344d797769636d567762334e706447397965534936496e6c6f62444534584339336356396d636d46745a534973496e567a5a5849694f6e736964584e6c636d3568625755694f694a35614777784f434973496d3568625755694f694a4e636c6c6c4e5467324f534973496d567459576c73496a6f694e5455314f4455784f544241635845755932397449697769644739725a5734694f6949334d5455784e3252694d7a63344d4751794d6a41324d6a63314f546c6c4d6a4d305a5452684f4759354e694973496d463164476876636d6c365a53493665794a7764577873496a7030636e566c4c434a7764584e6f496a7030636e566c4c434a685a4731706269493664484a315a58313966512e5272743941715872626d626548742d45764c73522d313155306c77794867426f46464e3565686b4b706155) 添加图片水印 ------ [](#添加图片水印) 系统支持添加图片及文字水印，下面依次举例说明 添加图片水印，我们下载框架logo文件到根目录进行举例： ``` $water = icarexm\image\Water::open('image.png', ROOT_PATH); // 给原图中间添加水印并保存image.water.png $water->water('logo.png', icarexm\image\Water::WATER_CENTER)->save(); //获取相对路径 echo $water->getSrcname(); //获取完整路径 echo $water->getPathname(); ``` 生成的图片效果如下： [![](https://camo.githubusercontent.com/df42f77ed64a3d6200cea504d353e9fbd9df1d32dde0fa8929bf7d8b6c978905/68747470733a2f2f6769742e6b616e636c6f75642e636e2f7265706f732f79686c31382f77715f6672616d652f7261772f633962663364363431376338303736663036366335376364313561633536353634383333636164312f696d616765732f6265696a696e672e77617465722e6a70673f6163636573732d746f6b656e3d65794a30655841694f694a4b563151694c434a68624763694f694a49557a49314e694a392e65794a6c654841694f6a45314f5441314e4445794f444d73496d6c68644349364d5455354d4451354f4441344d797769636d567762334e706447397965534936496e6c6f62444534584339336356396d636d46745a534973496e567a5a5849694f6e736964584e6c636d3568625755694f694a35614777784f434973496d3568625755694f694a4e636c6c6c4e5467324f534973496d567459576c73496a6f694e5455314f4455784f544241635845755932397449697769644739725a5734694f6949334d5455784e3252694d7a63344d4751794d6a41324d6a63314f546c6c4d6a4d305a5452684f4759354e694973496d463164476876636d6c365a53493665794a7764577873496a7030636e566c4c434a7764584e6f496a7030636e566c4c434a685a4731706269493664484a315a58313966512e5272743941715872626d626548742d45764c73522d313155306c77794867426f46464e3565686b4b706155)](https://camo.githubusercontent.com/df42f77ed64a3d6200cea504d353e9fbd9df1d32dde0fa8929bf7d8b6c978905/68747470733a2f2f6769742e6b616e636c6f75642e636e2f7265706f732f79686c31382f77715f6672616d652f7261772f633962663364363431376338303736663036366335376364313561633536353634383333636164312f696d616765732f6265696a696e672e77617465722e6a70673f6163636573732d746f6b656e3d65794a30655841694f694a4b563151694c434a68624763694f694a49557a49314e694a392e65794a6c654841694f6a45314f5441314e4445794f444d73496d6c68644349364d5455354d4451354f4441344d797769636d567762334e706447397965534936496e6c6f62444534584339336356396d636d46745a534973496e567a5a5849694f6e736964584e6c636d3568625755694f694a35614777784f434973496d3568625755694f694a4e636c6c6c4e5467324f534973496d567459576c73496a6f694e5455314f4455784f544241635845755932397449697769644739725a5734694f6949334d5455784e3252694d7a63344d4751794d6a41324d6a63314f546c6c4d6a4d305a5452684f4759354e694973496d463164476876636d6c365a53493665794a7764577873496a7030636e566c4c434a7764584e6f496a7030636e566c4c434a685a4731706269493664484a315a58313966512e5272743941715872626d626548742d45764c73522d313155306c77794867426f46464e3565686b4b706155) `water`方法的第二个参数表示水印的位置，默认值是`WATER_SOUTH`，可以传入下列`icarexm\image\Water`类的常量或者对应的数字： ``` //常量，标识左上角水印 const WATER_NORTHWEST = 1; //常量，标识上居中水印 const WATER_NORTH = 2; //常量，标识右上角水印 const WATER_NORTHEAST = 3; //常量，标识左居中水印 const WATER_WEST = 4; //常量，标识居中水印 const WATER_CENTER = 5; //常量，标识右居中水印 const WATER_EAST = 6; //常量，标识左下角水印 const WATER_SOUTHWEST = 7; //常量，标识下居中水印 const WATER_SOUTH = 8; //常量，标识右下角水印 const WATER_SOUTHEAST = 9; ``` 添加文字水印 ------ [](#添加文字水印) 系统支持添加图片及文字水印，下面依次举例说明 添加图片水印，我们下载框架logo文件到根目录进行举例： ``` $water = icarexm\image\Water::open('image.png', ROOT_PATH); // 给原图中间添加文字水印并保存image.water.png $water->text('TinyFrame', 18, '#00000000', icarexm\image\Water::WATER_CENTER)->save(); //获取相对路径 echo $water->getSrcname(); //获取完整路径 echo $water->getPathname(); ``` 生成的图片效果如下： [![](https://camo.githubusercontent.com/8f5a337140cb4ca9a2a85254bdf60350aec917658e53b2401782492ee3d77dd6/68747470733a2f2f6769742e6b616e636c6f75642e636e2f7265706f732f79686c31382f77715f6672616d652f7261772f633962663364363431376338303736663036366335376364313561633536353634383333636164312f696d616765732f6265696a696e672e77617465725f313538373535343934373035312e6a70673f6163636573732d746f6b656e3d65794a30655841694f694a4b563151694c434a68624763694f694a49557a49314e694a392e65794a6c654841694f6a45314f5441314e4445794f444d73496d6c68644349364d5455354d4451354f4441344d797769636d567762334e706447397965534936496e6c6f62444534584339336356396d636d46745a534973496e567a5a5849694f6e736964584e6c636d3568625755694f694a35614777784f434973496d3568625755694f694a4e636c6c6c4e5467324f534973496d567459576c73496a6f694e5455314f4455784f544241635845755932397449697769644739725a5734694f6949334d5455784e3252694d7a63344d4751794d6a41324d6a63314f546c6c4d6a4d305a5452684f4759354e694973496d463164476876636d6c365a53493665794a7764577873496a7030636e566c4c434a7764584e6f496a7030636e566c4c434a685a4731706269493664484a315a58313966512e5272743941715872626d626548742d45764c73522d313155306c77794867426f46464e3565686b4b706155)](https://camo.githubusercontent.com/8f5a337140cb4ca9a2a85254bdf60350aec917658e53b2401782492ee3d77dd6/68747470733a2f2f6769742e6b616e636c6f75642e636e2f7265706f732f79686c31382f77715f6672616d652f7261772f633962663364363431376338303736663036366335376364313561633536353634383333636164312f696d616765732f6265696a696e672e77617465725f313538373535343934373035312e6a70673f6163636573732d746f6b656e3d65794a30655841694f694a4b563151694c434a68624763694f694a49557a49314e694a392e65794a6c654841694f6a45314f5441314e4445794f444d73496d6c68644349364d5455354d4451354f4441344d797769636d567762334e706447397965534936496e6c6f62444534584339336356396d636d46745a534973496e567a5a5849694f6e736964584e6c636d3568625755694f694a35614777784f434973496d3568625755694f694a4e636c6c6c4e5467324f534973496d567459576c73496a6f694e5455314f4455784f544241635845755932397449697769644739725a5734694f6949334d5455784e3252694d7a63344d4751794d6a41324d6a63314f546c6c4d6a4d305a5452684f4759354e694973496d463164476876636d6c365a53493665794a7764577873496a7030636e566c4c434a7764584e6f496a7030636e566c4c434a685a4731706269493664484a315a58313966512e5272743941715872626d626548742d45764c73522d313155306c77794867426f46464e3565686b4b706155) ### Health Score 16 — LowBetter than 4% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity0 Limited adoption so far Community7 Small or concentrated contributor base Maturity34 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/a45259241de6b05216481510f09ae2978e5dc161ed01a0ce68bf2eb097ffb34f?d=identicon)[icarexm](/maintainers/icarexm) --- Top Contributors [![icarexm](https://avatars.githubusercontent.com/u/65947546?v=4)](https://github.com/icarexm "icarexm (1 commits)") ### Embed Badge ![Health badge](/badges/icarexm-image/health.svg) ``` [![Health](https://phpackages.com/badges/icarexm-image/health.svg)](https://phpackages.com/packages/icarexm-image) ``` ### Alternatives [rappasoft/laravel-patches Run patches migration style in your Laravel applications. 5175.0k](/packages/rappasoft-laravel-patches)[kunstmaan/utilities-bundle The KunstmaanUtilitiesBundle makes your life easier by providing a couple of small but usefull helper services you can use and re-use in your applications. We already implemented an easy to use cipher service and a shell helper service for you but feel free to send in a pull request with your additions. The shell helper allows you to run apps in the background, see if a process is running and has a method to kill a running process. The cipher service allow you to encode and decode strings using the Rijndael 256 cipher 12152.1k6](/packages/kunstmaan-utilities-bundle)[dusanbre/laravel-tolgee Help with Laravel integration of Tolgee service 146.6k](/packages/dusanbre-laravel-tolgee) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)