[{"_1":2,"_155":-5,"_156":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_134":135},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_125":-5,"_126":11,"_127":17,"_128":11,"_129":-5,"_130":11,"_131":-5,"_132":133},"canonicalUrl","https://hub.docker.com/r/skorge/flyimg-dev/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","skorge","reponame","flyimg-dev","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2019-03-28T11:20:32.159233Z","description","Testing personal changes","is_private","last_updated","2019-03-28T12:03:17.292083Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",83,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","\n

\n\n

\n $\"Backers$ \n $\"Sponsors$ \n $\"Build$ \n $\"Code$ \n $\"Issue$ \n $\"Test$ \n $\"SensioLabsInsight\"$ \n $\"License\"$ \n $\"Latest$ \n

\n\n# Flyimg\n\nImage resizing, cropping and compression on the fly with the impressive [MozJPEG](http://calendar.perfplanet.com/2014/mozjpeg-3-0) compression algorithm. One Docker container to build your own Cloudinary-like service.\n\n### Fetch an image from anywhere; resize, compress, cache and serve... and serve, and serve, and serve...\n\nYou pass the image URL and a set of keys with options, like size or compression. Flyimg will fetch the image, convert it, store it, cache it and serve it. The next time the request comes, it will serve the cached version.\n\n```\n\n

\n```\n# Basic Usage Examples\n## Get an image to fill exact dimensions\n* Image: `https://m0.cl/t/butterfly-3000.jpg` \n* Width: 300\n* Height: 250\n* Crop if necesary: `c_1`\n\nhttps://oi.flyimg.io/upload/w_300,h_250,c_1/https://m0.cl/t/butterfly-3000.jpg\n\n![lago_ranco](https://oi.flyimg.io/upload/w_300,h_250,c_1,o_jpg/https://m0.cl/t/butterfly-3000.jpg)\n\nThis will serve the image.\n\n## Get the path to the generated image instead of serving it\nChange the first part of the path from `upload` to `path`, like so:\n\nhttps://oi.flyimg.io/path/w_300,h_250,c_1/https://m0.cl/t/butterfly-3000.jpg will output in the body of the response:\n\n\n```\nhttp://localhost:8080/uploads/752d2124eef87b3112779618c96468da.jpg\n```\n\n## Get an image to fit maximum dimensions\n* Image: `https://m0.cl/t/butterfly-3000.jpg` \n* Width: 300\n* Height: 250\n* Note that we ommit the crop parameter\n\nhttps://oi.flyimg.io/upload/w_300,h_250/https://m0.cl/t/butterfly-3000.jpg\n\n![lago_ranco](https://oi.flyimg.io/upload/w_300,h_250,o_jpg/https://m0.cl/t/butterfly-3000.jpg)\n\n## Crop to a square and rotate 90 degrees clockwise\n* Image: `https://m0.cl/t/butterfly-3000.jpg` \n* Width: 200\n* Height: 200\n* Crop: `c_1`\n* Rotate: 90\n\nhttps://oi.flyimg.io/upload/w_200,h_200,c_1,r_90/https://m0.cl/t/butterfly-3000.jpg\n\n![lago_ranco](https://oi.flyimg.io/upload/w_200,h_200,c_1,r_90,o_jpg/https://m0.cl/t/butterfly-3000.jpg)\n\n## Get an image with exact dimensions and low quality\n* Image: `https://m0.cl/t/butterfly-3000.jpg` \n* Width: 200\n* Height: 200\n* Crop: `c_1`\n* Quality: 30\n\nhttps://oi.flyimg.io/upload/w_200,h_200,c_1,q_30/https://m0.cl/t/butterfly-3000.jpg\n\n![lago_ranco](https://oi.flyimg.io/upload/w_200,h_200,c_1,q_30,o_jpg/https://m0.cl/t/butterfly-3000.jpg)\n\n\n# Table of Contents\n\n * [Requirements](#requirements)\n * [Installation [Deployment mode]](#installation-deployment-mode)\n * [Installation [Development Mode]](#installation-development-mode)\n * [Installation](#installation)\n * [with git](#with-git)\n * [with composer](#with-composer)\n * [Testing Flyimg service](#testing-flyimg-service)\n * [How to transform images](#how-to-transform-images)\n * [Basic Option details](#basic-option-details)\n * [Full Option details](https://github.com/flyimg/flyimg/blob/master/docs/url-options.md)\n * [Application Server Options](#server-options)\n * [Security: Restricting Source Domains](#security-restricting-source-domains)\n * [Security: Signature Generation](#security-signature-generation)\n * [Run Unit Tests](#run-unit-tests)\n * [How to Provision the application on](#how-to-provision-the-application-on)\n * [Technology stack](#technology-stack)\n * [Abstract storage with Flysystem](#abstract-storage-with-flysystem)\n * [Benchmark](#benchmark)\n * [Enable Xdebug](https://github.com/flyimg/flyimg/blob/master/docs/enabling-xdebug.md)\n * [Demo Application running](#demo-application-running)\n * [Roadmap](#roadmap)\n * [Community](#community)\n * [Supporters](#supporters)\n * [Contributors](#contributors)\n * [Backers](#backers)\n * [Sponsors](#sponsors)\n * [License](#license)\n \n \n# Requirements\n\nYou will need to have **Docker** on your machine. Optionally you can use Docker machine to create a virtual environment. We have tested on **Mac**, **Windows** and **Ubuntu**.\n\n# Installation [Deployment mode]\n\nPull the docker image\n\n```bash\ndocker pull flyimg/flyimg-build\n```\n\nStart the container\n\n```bash\ndocker run -itd -p 8080:80 flyimg/flyimg-build\n```\nCheck [how to provision the application](#how-to-provision-the-application-on)\n\n# Installation [Development Mode]\n\nYou can spin up your own working server in 10 minutes using the provision scripts for [AWS Elastic Beanstalk](https://github.com/flyimg/Elastic-Beanstalk-provision) or the [DigitalOcean Ubuntu Droplets](https://github.com/flyimg/DigitalOcean-provision) (more environments to come). For other environments or if you want to tweak and play in your machine before rolling out, read along...\n\n## Installation\n\nYou can use `git` or `composer` for the first step. \n\n### with git\n\n```sh\ngit clone https://github.com/flyimg/flyimg.git\n```\n### with composer\nCreate the project with `composer create` .\n\n```sh\ncomposer create-project flyimg/flyimg\n```\n\n**CD into the folder** and to build the docker image by running:\n\n```sh\ndocker build -t flyimg .\n```\nThis will download and build the main image, It will take a few minutes. If you get some sort of error related to files not found by apt-get or similar, try this same command again.\n\n**IMPORTANT!** If you cloned the project, only for the first time, you need to run `composer install` **inside** the container:\n\n```sh\ndocker exec -it flyimg composer install\n```\n\nAgain, it will take a few minutes to download the dependencies. Same as before, if you get some errors you should try running `composer install` again.\n\nThen run the container:\n\n```sh\ndocker run -itd -p 8080:80 -v $(pwd):/var/www/html --name flyimg flyimg\n```\n\nFor Fish shell users: \n\n```sh\ndocker run -itd -p 8080:80 -v $PWD:/var/www/html --name flyimg flyimg\n```\n\nThe above command will make the Dockerfile run supervisord command which launches 2 processes: **nginx** and **php-fpm** and starts listening on port 8080.\n \n\n# Testing Flyimg service\n\nYou can navigate to your machine's IP in port 8080 (ex: http://127.0.0.1:8080/ ) ; you should get a message saying: **Hello from Flyimg!** and a small homepage of Flyimg already working. If you get any errors at this stage it's most likely that composer has not finished installing or skipped something.\n\nYou can test your image resizing service by navigating to: http://127.0.0.1:8080/upload/w_130,h_113,q_90/https://m0.cl/t/butterfly-3000.jpg\n\n![ff-logo](https://oi.flyimg.io/upload/w_130,h_113,q_90,o_jpg/https://m0.cl/t/butterfly-3000.jpg)\n\n**It's working!**\n\nThis is fetching an image from Mozilla, resizing it, saving it and serving it.\n\n\n# How to transform images\n\nYou go to your server URL`http://imgs.kitty.com` and append `/upload/`; after that you can pass these options below, followed by an underscore and a value `w_250,q_50` Options are separated by coma (configurable to other separator).\n\nAfter the options put the source of your image, it can be relative to your server or absolute: `/https://my.storage.io/imgs/pretty-kitten.jpg`\n\nSo to get a pretty kitten at 250 pixels wide, with 50% compression, you would write.\n`

`\n\n\n## Basic Option details\nYou can see the full list of options configurable by URL params, **with examples**, in the [URL-Options document](docs/url-options.md) \n\nWe put a lot of defaults in place to prevent distortion, bad quality, weird cropping and unwanted padding.\n\nThe most common URL options are:\n\n### `w` : width\n`int` \n*Default:* `null` \n*Description:* Sets the target width of the image. If not set, width will be calculated in order to keep aspect ratio.\n\n**example:`w_100`** \n\n`w_100` : `https://oi.flyimg.io/upload/w_100/https://m0.cl/t/butterfly-3000.jpg`\n\n### `h` : height\n`int` \n*Default:* `null` \n*Description:* Sets the target height of the image. If not set, height will be calculated in order to keep aspect ratio.\n\n**example:`h_100`** \n\n`h_100` : `https://oi.flyimg.io/upload/h_100/https://m0.cl/t/butterfly-3000.jpg`\n\n### Using width AND height\n\n**example:`h_300,w_300`** \nBy default setting width and height together, works like defining a rectangle that will define a **max-width** and **max-height** and the image will scale proportionally to fit that area without cropping.\n\nBy default; width, height, or both will **not scale up** an image that is smaller than the defined dimensions.\n\n`h_300,w_300` : `https://oi.flyimg.io/upload/h_300,w_300/https://m0.cl/t/butterfly-3000.jpg`\n\n\n### `c` : crop\n`bool` \n*Default:* `false` \n*Description:* When both width and height are set, this allows the image to be cropped so it fills the **width x height** area.\n\n**example:`c_1`** \n\n`c_1,h_400,w_400` : `https://oi.flyimg.io/upload/c_1,h_400,w_400/https://m0.cl/t/butterfly-3000.jpg`\n\n### `g` : gravity\n`string` \n*Default:* `Center` \n*Description:* When crop is applied, changing the gravity will define which part of the image is kept inside the crop area.\nThe basic options are: `NorthWest`, `North`, `NorthEast`, `West`, `Center`, `East`, `SouthWest`, `South`, `SouthEast`.\n\n**example:`g_West`** \n\n### `r` : rotate\n`string` \n*Default:* `null` \n*Description:* Apply image rotation (using shear operations) to the image. \n\n**example: `r_90`, `r_-180`,...**\n\n`r_45` : `https://oi.flyimg.io/upload/r_-45,w_400,h_400/https://m0.cl/t/butterfly-3000.jpg`\n\n### `o` : output\n`string` \n*Default:* `auto` \n*Description:* Output format requested, for example you can force the output as jpeg file in case of source file is png. The default `auto` will try to output the best format for the requesting browser, falling back to the same format as the source image or finally with a fallback to **jpg**.\n\n**example:`o_auto`,`o_input`,`o_png`,`o_webp`,`o_jpeg`,`o_jpg`**\n\n### `q` : quality\n`int` (0-100) \n*Default:* `90` \n*Description:* Sets the compression level for the output image. Your best results will be between **70** and **95**.\n\n**example:`q_100`,`q_75`,...** \n\n`q_30` : `https://oi.flyimg.io/upload/q_30/https://m0.cl/t/butterfly-3000.jpg` \n\n\n`q_100` : `https://oi.flyimg.io/upload/q_100/https://m0.cl/t/butterfly-3000.jpg`\n\n### Refresh or re-fetch source image\n`rf` : refresh \n*Default:* `false` \n*Description:* When this parameter is 1, it will force a re-request of the original image and run it through the transformations and compression again. It will delete the local cached copy.\n\n**example:`rf_1`** \n\n## Face Detection options\n\n### `fc` : face-crop\n`int`\n*Default:* `0`\n*Description:* Using [facedetect](https://github.com/wavexx/facedetect) repository to detect faces and passe the coordinates to ImageMagick to crop.\n\n**example:`fc_1`** \n\n`fc_1` : `https://oi.flyimg.io/upload/fc_1/http://facedetection.jaysalvat.com/img/faces.jpg`\n\n![fc_1](https://oi.flyimg.io/upload/fc_1,o_jpg/http://facedetection.jaysalvat.com/img/faces.jpg)\n\n### `fcp` : face-crop-position\n`int`\n*Default:* `0`\n*Description:* When using the Face crop option and when the image contain more than one face, you can specify which one you want get cropped\n\n**example:`fcp_1`,`fcp_0`,...** \n\n`fcp_2` : `https://oi.flyimg.io/upload/fc_1,fcp_2/http://facedetection.jaysalvat.com/img/faces.jpg`\n\n![fcp_2](https://oi.flyimg.io/upload/fc_1,fcp_2,o_jpg/http://facedetection.jaysalvat.com/img/faces.jpg)\n\n### `fb` : face-blur\n`int`\n*Default:* `0`\n*Description:* Apply blur effect on faces in a given image\n\n**example:`fb_1`** \n\n`fb_1` : `https://oi.flyimg.io/upload/fb_1/http://facedetection.jaysalvat.com/img/faces.jpg`\n\n![fb_1](https://oi.flyimg.io/upload/fb_1,o_jpg/http://facedetection.jaysalvat.com/img/faces.jpg)\n\n\n--- \n\n## Server Options\n\nThere are some easy to setup server configurations in the `config/parameters.yml` file, you can see the full list of options and server configurations in the **[Application Options Document](docs/application-options.md)** \n\n## Security: Restricting Source Domains:\n\nRestricted domains disabled by default. This means that you can fetch a resource from any URL. To enable the domain restriction, change in config/parameters.yml \n\n```yml\nrestricted_domains: true\n```\n\nAfter enabling, you need to put the white listed domains\n\n```yml\nwhitelist_domains:\n - www.domain-1.org\n - www.domain-2.org\n```\n## Security: Signature Generation:\n\nBased on this [RFC](https://github.com/flyimg/flyimg/issues/96) Signature Generation was added to Flyimg in order to avoid DDOS attacks.\n\nFirst you need to edit `security_key` and `security_iv` in parameters.yml file and add a proper values.\nThan any request to Fyimg app will throw an error unless it's encrypted.\n\nTo generate the encrypted url you need to run this command:\n\n```sh\ndocker exec flyimg php app.php encrypt w_200,h_200,c_1/https://m0.cl/t/butterfly-3000.jpg\n```\n\nit'll return something like this:\n\n```sh\nHashed request: TGQ1WWRKVGUrZUpoNmJMc2RMUENPL2t6ZDJkWkdOejlkM0p0U0F3WTgxOU5IMzF3U3R0d2V4b3dqbG52cFRTSFZDcmhrY1JnaGZYOHJ3V0NpZDNNRmc9PQ==\n```\n\nNow you can request the image throw this new url:\n\n```\nhttp://localhost:8080/upload/TGQ1WWRKVGUrZUpoNmJMc2RMUENPL2t6ZDJkWkdOejlkM0p0U0F3WTgxOU5IMzF3U3R0d2V4b3dqbG52cFRTSFZDcmhrY1JnaGZYOHJ3V0NpZDNNRmc9PQ==\n```\n\n\n## Run Unit Tests:\n\n```sh\ndocker exec flyimg vendor/bin/phpunit\n```\n\nGenerate Html Code Coverage\n```sh\ndocker exec flyimg vendor/bin/phpunit --coverage-html build/html\n```\n\n## How to Provision the application on:\n\n- [DigitalOcean](https://github.com/flyimg/DigitalOcean-provision)\n- [AWS Elastic-Beanstalk](https://github.com/flyimg/Elastic-Beanstalk-provision)\n\n# Technology stack\n\n* Server: nginx\n* Application: [Silex](http://silex.sensiolabs.org/) , a PHP micro-framework.\n* Image manipulation: ImageMagick\n* JPEG encoder: MozJpeg\n* Storage: [Flysystem](http://flysystem.thephpleague.com/)\n* Containerisation: Docker\n\n## Abstract storage with Flysystem\n\nStorage files based on [Flysystem](http://flysystem.thephpleague.com/) which is `a filesystem abstraction allows you to easily swap out a local filesystem for a remote one. Technical debt is reduced as is the chance of vendor lock-in.`\n\nDefault storage is Local, but you can use other Adapters like AWS S3, Azure, FTP, DropBox, ... \n\nCurrently, only the **local** and **S3** are implemented as Storage Provider in Flyimg application, but you can add your specific one easily in `src/Core/Provider/StorageProvider.php`. Check an [example for AWS S3 here](https://github.com/flyimg/flyimg/blob/master/docs/application-options.md#using-aws-s3-as-storage-provider).\n\n# Benchmark\n\nSee [benchmark.sh](https://github.com/flyimg/flyimg/blob/master/benchmark.sh) for more details.\n\nRequires: **Vegeta**[http://github.com/tsenart/vegeta](http://github.com/tsenart/vegeta)\n\n```\n./benchmark.sh\n```\n\nLatest Results:\n```\nCrop http://localhost:8080/upload/w_200,h_200,c_1/Rovinj-Croatia.jpg\nRequests [total, rate] 500, 50.10\nDuration [total, attack, wait] 9.991377689s, 9.97999997s, 11.377719ms\nLatencies [mean, 50, 95, 99, max] 19.402096ms, 12.844271ms, 54.65001ms, 96.276948ms, 135.597203ms\nBytes In [total, mean] 5337500, 10675.00\nBytes Out [total, mean] 0, 0.00\nSuccess [ratio] 100.00%\nStatus Codes [code:count] 200:500\n\nResize http://localhost:8080/upload/w_200,h_200,rz_1/Rovinj-Croatia.jpg\nRequests [total, rate] 500, 50.10\nDuration [total, attack, wait] 9.992435445s, 9.979999871s, 12.435574ms\nLatencies [mean, 50, 95, 99, max] 16.676093ms, 12.376525ms, 49.676187ms, 97.354697ms, 127.14737ms\nBytes In [total, mean] 3879500, 7759.00\nBytes Out [total, mean] 0, 0.00\nSuccess [ratio] 100.00%\nStatus Codes [code:count] 200:500\n\nRotate http://localhost:8080/upload/r_-45,w_400,h_400/Rovinj-Croatia.jpg\nRequests [total, rate] 500, 50.10\nDuration [total, attack, wait] 9.992650741s, 9.979999937s, 12.650804ms\nLatencies [mean, 50, 95, 99, max] 13.634143ms, 11.587252ms, 26.873827ms, 50.446923ms, 68.222253ms\nBytes In [total, mean] 17609000, 35218.00\nBytes Out [total, mean] 0, 0.00\nSuccess [ratio] 100.00%\nStatus Codes [code:count] 200:500\n```\n\n# Demo Application running\n\n[https://oi.flyimg.io](https://oi.flyimg.io)\n\n![resize-test](https://oi.flyimg.io/upload/w_300,h_250,c_1,o_jpg/https://m0.cl/t/butterfly-3000.jpg)\n\n\n# Roadmap\n\n- [x] Benchmark the application.\n- [ ] Decouple the core logic from Silex in order to make it portable.\n- [ ] Add overlays functionality (Text on top of the image)\n- [ ] Storage auto-mapping\n- [ ] Add support for FLIFF, BPG and JPEG2000\n\n# Generate CHANGELOG\n\n`github-changes -o flyimg -r flyimg -a -k GITHUB-TOKEN --only-pulls --use-commit-body`\n\n# Community\n\n* Follow us on [GitHub][1] and [Twitter][2].\n\n# Supporters\n\nA special thanks to JetBrains for supporting our project with their [open source license program](https://www.jetbrains.com/buy/opensource/).\n\n![Jetbrains](https://oi.flyimg.io/upload/w_300,o_jpg/jetbrains-variant-3.png)\n\n\n# Contributors\n\nThis project exists thanks to all the people who contribute.\n

\n\n\n# Backers\n\nThank you to all our backers! [[Become a backer](https://opencollective.com/flyimg#backer)]\n\n

\n\n\n# Sponsors\n\nThank you to all our sponsors! (please ask your company to also support this open source project by [becoming a sponsor](https://opencollective.com/flyimg#sponsor))\n\n

\n\n\n\n# License\n\nThe MIT License (MIT). Please see [License File](LICENSE) for more information.\n\n\nEnjoy your Flyimaging!\n\n[1]: https://github.com/flyimg\n[2]: https://twitter.com/flyimg_\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",398256997,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},"content_type","creator",1141233,"full_size",395989622,"id",51113315,"images",[97],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},"architecture","amd64","digest","sha256:baf50a00519064690b9adaf0f3ebba54a1a5fdc5c1e1de92f5b5051fae70dcac","features","","last_pulled","2026-09-09T23:52:09.679205083Z","last_pushed","2019-03-28T12:03:17Z","os","linux","os_features","os_version","size","variant","2019-03-28T12:03:16.964667Z","last_updater","last_updater_username","media_type","dev","repository",6896701,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":136,"_143":144,"_132":153,"_154":11},{"_36":137,"_38":138,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":139,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":140,"_75":11,"_76":142,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":141},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_145":60,"_146":-5,"_147":-5,"_148":149},"count","next","previous","results",[150],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":151,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},[152],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

skorge/flyimg-dev

Tags for skorge/flyimg-dev