Skip to content

simple-works/random-image

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

17 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎲 Random Image

Web PHP

Web API that responds with a random image.

🌐 View Live

Screenshot

πŸ“‚ Endpoints

πŸ“ Directory Endpoint

GET random image from Local Directory (./dir/images).

  • 🌐 ./dir : returns Image File.
  • 🌐 ./dir?json : returns JSON File with this data:
    • title : friendly image title (ex: "Wracurd")
    • name : image file name with extension (ex: "wracurd_paint_p_ft.jpg").
    • type : image file mime type (example: "image/jpeg").
    • url : image file full url (example: "https://random-image.com/dir/images/wracurd_paint_p_ft.jpg").

πŸ“ RSS Endpoint

GET random image from RSS Feed.

  • 🌐 ./rss : returns Image File.

JSON Generation

The JSON file data is fully based on the image file.

  • title is extracted from the image file name following this method:
    • If the name contains an underscore _, only the part that preceeds the underscore _ is taken. Else, the full name is taken.
    • The hyphens - in the name are replaced with spaces.
    • The first word is capitalized.
  • title extraction example:
    • quest in-the-City_paint_p_ft
    • β†’ quest in-the-City
    • β†’ quest in the City
    • β†’ Quest in the City

πŸš€ Development

🏭 Environment

πŸŒ‘ Backend

  • βš›οΈ Core: PHP

πŸ“„ License