setFieldUpload

setFieldUpload(string $fieldName, string $privateUploadFolder, string $publicFolderPath [, array $options])

There is a special type of field for uploading data or images and in order to trigger this type, you will need to use the setFieldUpload method. The usage is fairly easy and everything will work out of the box. You just need to make sure that the server has access to the specified folders.

The method is taking 3 parameters:

The first parameter is the field name in the database. Have in mind that only the name of the file (without the full path) is stored
The second parameter is the field that the file will actually be stored. If the path is the same as the public one then the second parameter will be the same with the 3rd
The public path that the file can be accessed by the end-user that will need to be the full path

Example

$crud->setFieldUpload('image', 'uploader/customer-image', '/assets/images/customers');

Notice: Please have in mind that the public path will need to have the full URL of the folder. For example if you are using Codeigniter and the public path is the same with the private path then you will need to do something like this:

$crud->setFieldUpload('profile_image', 'assets/uploads', base_url() . '/assets/uploads');

For security reasons of this website we currently don't have a full example of the setFieldUpload.

Upload validations per field

After version 2.9.0 we also have a 4th parameter into the function that you can specify the upload validations per field. More specifically we have:

maxUploadSize. String value to specify the maximum upload size that a user can upload per file. Default: '20M' (20 Mega Bytes). Use "B", "K", "M" or "G".
minUploadSize. String value to specify the minimum upload size that a user can upload per file. Default: '1B' (1 Byte). Use "B", "K", "M" or "G".

allowedFileTypes. An array of string values to specify the allowed field types. Default:

['gif', 'jpeg', 'jpg', 'png', 'svg', 'tiff', 'doc', 'docx',  'rtf', 'txt', 'odt', 'xls', 'xlsx', 'pdf',
'ppt', 'pptx', 'pps', 'ppsx', 'mp3', 'm4a', 'ogg', 'wav', 'mp4', 'm4v', 'mov', 'wmv', 'flv', 'avi',
'mpg', 'ogv', '3gp', '3g2']

Example:

$uploadValidations = [
    'maxUploadSize' => '20M', // 20 Mega Bytes
    'minUploadSize' => '1K', // 1 Kilo Byte
    'allowedFileTypes' => [
        'gif', 'jpeg', 'jpg', 'png', 'tiff'
    ]
];
$crud->setFieldUpload(
    'image', 
    'uploader/customer-image', 
    '/assets/images/customers', 
    $uploadValidations
);