Lucee - Extensions running cfimage in lambda

20 Jun 2020

In the previous article on CFML I provided a more in-depth look at CFML in lambda. In this post we will explore how to install extensions so we can use functions such as cfimage of the AWS S3 extensions in cfml.

The demo url is:

https://ajzmevckf1.execute-api.ap-southeast-2.amazonaws.com/Prod/image.cfm?img=https://cdn.kukiel.dev/cows.jpg

You can try your own image as follows:

# jpeg, png, gif all should work
https://ajzmevckf1.execute-api.ap-southeast-2.amazonaws.com/Prod/image.cfm?img=https://{url}/{image}.jpg

This was actually much easier than expected, I thought at first I’d need to drop in some extra jars, or open the lucee lite jar and add the lex files to the extensions folder then zip it back up, but it was easier than that. Lucee extensions will be picked up and installed via environment variables. We easily have this in the SAM template so literally 1 line I had the extension installed:

      Environment:
        Variables:
          FELIX_CACHE_BUFSIZE: 16384
          LUCEE_EXTENSIONS: 'B737ABC4-D43F-4D91-8E8E973E37C40D1B;name=cfimage;version=1.0.0.35,17AB52DE-B300-A94B-E058BD978511E39E;name=cfs3;version=0.9.4.122'

In the example above 2 extensions are installed: Image extension and S3 Resource Extension

The ID comes from: https://download.lucee.org, this is simply the ID of the extension, name is a name ( can be anything ) version is well the version.

Here is some example code:

<cfscript>

    cfheader( name="Content-Type", value="text/html" );

    if(structKeyExists(url,'img')){
        imgUrl = url['img']
    }else{
        imgUrl="https://avatars1.githubusercontent.com/u/10973141?s=280&v=4"
    }
    
    // Download the image into a CFML image variable.
    cfimage(action="read",name="sourceImage",source=imgUrl);
    // Get the mete data of the file
    cfimage(action="info",structname="original",source=sourceImage);
   
    // Maintain spect ratio.
    newWidth = 320;
    newHeight = (original.height/original.width) * newWidth;

    // resize the image
    cfimage(action="resize",source=sourceImage,name="resized",
        height=newHeight,width=newWidth,quality="1");
    
    // Deep copy the image, cfimage rotate rotates the original as well as the output?  Meh, seems like an issue?
    copy = Duplicate(resized);
    writeOutput("<strong>Original Image:</strong><br/>" & resized & "<br/>");

    // Turn the image upside down
    cfimage(action="rotate",source=resized,angle="180",name="upsideDownImage");
    writeOutput("<strong>Rotated Image:</strong><br/>" & upsideDownImage & "<br/>");

    // Covert to greyscale
    imageGrayscale(copy);
    writeOutput("<strong>GreyScale Image:</strong><br/>" & copy);

</cfscript>

Example output:

Loading the extension means the startup time will take a bit of a hit. Perhaps there is a better way, I suspect the future would be a custom layer for lucee and that should enable us to pre-package extensions.