PHP download

Download the PHP package hostkurd/flocms-uploader without Composer

On this page you can find all versions of the php package hostkurd/flocms-uploader. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download hostkurd/flocms-uploader
More information about hostkurd/flocms-uploader
Files in hostkurd/flocms-uploader

Vendor hostkurd
Package flocms-uploader
Short Description Professional file and image upload package for FloCMS with local, private and S3-ready storage drivers.
License MIT

Keywords storage s3 upload images uploader flocms

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.

Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
To use Composer is sometimes complicated. Especially for beginners.
Composer needs much resources. Sometimes they are not available on a simple webspace.
If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.

Please rate this library. Is it a good library?

Example code of hostkurd/flocms-uploader

Informations about the package flocms-uploader

FloCMS Uploader

hostkurd/flocms-uploader is a production-ready upload package for FloCMS. It supports:

local public uploads
local private uploads
AWS S3 uploads
secure MIME and extension validation
random filenames by default
optional original-name preservation
date-based folders
single and multi-file uploads
image resizing, fitting, optimization, and version generation
GD or Imagick image drivers

Installation

For AWS S3 support:

Recommended FloCMS structure

public/uploads for publicly accessible assets like avatars, post images, and product photos.
storage/uploads for protected files like invoices, reports, and private user documents.

Configure the package

Create config/upload.php in your FloCMS app and copy the example from this package.

A good place to do that is inside your bootstrap sequence, right after your framework loads config.

Example config

Basic file upload

Directory selection

You can choose the target directory per upload:

Multiple uploads

Image uploads with versions

The original image is kept by default and stored under:

Generated versions are stored like:

AWS S3 example

Security notes

The package validates upload errors before moving files.
It uses finfo to detect MIME type.
It validates file extension and MIME type independently.
It uses random filenames by default.
It validates real images with getimagesize() before image processing.
It rejects traversal, absolute paths, unsafe path segments, and symlink escapes from local storage roots.
It calculates upload size from the temporary file rather than trusting the browser-provided size.
Common executable/script extensions are blocked by default. Configure blocked_extensions only if a private-storage use case requires a different policy.
A fixed filename cannot replace the extension that was validated.
It does not support SVG sanitization. Do not allow SVG uploads until you add a sanitizer.

Public API overview

`FloCMS\Uploader\Uploader`

configure(array $config): void
disk(string $disk): Uploader
make(?array $config = null): Uploader
onDisk(string $disk): self
directory(string $directory): self
to(string $directory): self
useDatePath(bool $enabled = true): self
preserveOriginalName(bool $enabled = true): self
filename(string $filename): self
visibility(string $visibility): self
allowExtensions(array $extensions): self
allowMimeTypes(array $mimes): self
maxBytes(int $bytes): self
imageDimensions(array $dimensions): self
upload(array $file, ?string $directory = null): UploadResult
uploadMany(array $files, ?string $directory = null): array

`FloCMS\Uploader\Image\ImageUploader`

versions(array $versions): self
keepOriginal(bool $enabled = true): self
optimize(bool $enabled = true): self
quality(int $quality): self
driver(string $driver): self

FloCMS integration suggestion

Inside your bootstrap after config is loaded:

Then your controllers can use the package directly.

Notes

Uploader::disk('public') is the clean entry point for regular files.
Uploader::image()->onDisk('public') is the clean entry point for image processing.
If you want a framework-level helper later, you can wrap this package with your own upload() or uploader() helper in FloCMS core.

All versions of flocms-uploader with dependencies

PHP Build Version

Package Version

Version v1.2.1 Release 16. Oct 2026
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of flocms-uploader from vendor hostkurd

Requires php Version >=8.1
ext-fileinfo Version *

Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package hostkurd/flocms-uploader contains the following files

Loading the files please wait ...