maymeow/cakephp-fileupload

🆙 File Upload plugin for CakePHP. This is mirror from my dev server. Package is available on packagist and on my dev serers's composer.

🆙 FileUpload plugin for CakePHP

⚠️ This is readme for version 2.x. For 1.x go to v1.1.2 release.

🛑 Breaking changes (read before use)

Version 2.x is not compatibile with cakephp lower than 5.x and it is not backward compatibile with previous releases of this plugins.

• S3 storage support was removed (will be added in future relases)
• Bunny CND storage support was added
• All components and Managers was rewritten.

And supported actions are upload and download.

Installation

You can install this plugin into your CakePHP application using composer.

The recommended way to install composer packages is:

🐘 From packagist

composer require maymeow/file-upload "^2.0.0"

Usage

Add configuration somewhere to your config files

'Storage' => [
    'defaultStorageType' => env('STORAGE_DEFAULT_STORAGE_TYPE', 'local'),
    'local' => [
        'managerClass' => LocalStorageManager::class,
        'storagePath' => env('STORAGE_LOCAL_STORAGE_PATH', ROOT . DS . 'storage' . DS),
    ],
    'bunny' => [
        'managerClass' => BunnyStorageManager::class,
        'cdnDomain' => env('BUNNY_STORAGE_CDN_DOMAIN', ''), // your cnd url
        'region' => env('BUNNY_STORAGE_REGION', ''), // region, empty is DE
        'baseHostName' => 'storage.bunnycdn.com', // base host name not changeable
        'storageZone' => env('BUNNY_STORAGE_ZONE', ''), // your storage zone name
        'storageZonePath' => env('BUNNY_STORAGE_ZONE_PATH', ''), // folder in zono
        'accessKey' => env('BUNNY_STORAGE_ACCESS_KEY', ''), // API key for write access
    ]
]

For bunny cdn minimal configuration is to have folowing keys configured

BUNNY_STORAGE_ACCESS_KEY=
BUNNY_STORAGE_CDN_DOMAIN=
BUNNY_STORAGE_ZONE=

If you need/want nginx to server your static files without PHP set STORAGE_LOCAL_STORAGE_PATH location to whe webroot folder.

Load plugin with adding

$this->addPlugin('FileUpload'); // in your Application.php bootstrap function

or you can add your plugin with plugins.php config file

return [
    // .. your other plugins
    'FileUpload' => [],
];

Loading components

$config = Configure::read('Storage.local'); // or Storage.bunny

// or by setting it with .env STORAGE_DEFAULT_STORAGE_TYPE
$storageType = Configure::read('Storage.defaultStorageType');
$config = Configure::read('Storage.' . $storageType); 

$this->loadComponent('FileUpload.Upload', $config);
$this->loadComponent('FileUpload.Download', $config);

Uploading files

$file = $this->Upload->getFile($this);
// do something with file

// store your file name in database
$file->getFileName(); // sanitized file name - with removed restricted characters in the name

$file = $this->Download->getFile($resource->name);
// do something with file

📝 Note that the function above will read content of file and you then need to use response to push it to the viewer. If you want to do it without using PHP you will need to get URL of file and if you using local storage manager your folder need to be in webrootfolder.

$file->get('storagePath'); // local: /patht/to/sorage or bunny: https://cdn.your.tld/path/to/folder/
// combine it with filename from your database go download it

License

MIT

cakephp-fileupload's Issues

Add eamples for UploadForm

In readme are missing examples for UploadForm.

delete file and record both

Using the standard CakePHP code, the delete will handle the record in the MySQL table, but not the file. How do you do both? This should be in the documentation.

Call to a member function getClientMediaType() on string

I followed the few instructions, and when I attempt to run the code, this is the error I get.

Perhaps what I am missing is something in the ./templates//add.php page that actually prompts the user for the file to upload. Can you add that code to the readme?

AWS s3 support

Implement ability to store and retrieve files from S3 compatible storage. For development purposes you can use Minio server

File : vendor/maymeow/file-upload/src/Storage/LocalStorageManager.php

File : vendor/maymeow/file-upload/src/Storage/LocalStorageManager.php

Function : move
$fileObject->moveTo($this->configuration->getConfig('storagePath') . $fileObject->getClientFilename());

this line is giving an error. if I print the path it is "storage/agent-registration-2.jpg"
As I said above my storage folder is parallel to src and webroot folder,

Originally posted by @TechnoPHP in #7 (comment)