TrophyCustomer's Canvas is honored with a 2020 InterTech Technology Award! Learn more 
This documentation is for the old version. Go to the latest Upload Suite docs

Maintaining Sessions and Authentication in PHP

If you are going to utilize Image Uploader Flash in non-Internet Explorer browsers (Firefox, Safari, and etc.), you should take care about keeping your session and authentication cookies saved if they are used. The fact is that Image Uploader Flash does not send cookies in output requests in non-Internet Explorer browsers by default and, therefore, session and authentication tickets are lost during the upload. To work around this problem you can employ special facilities provided either by Image Uploader Flash PHP or Image Uploader Flash JavaScript. Let us consider how to use them.

Using Image Uploader Flash PHP

If you use Image Uploader Flash PHP, session and authentication information will be automatically passed to the upload request. If you are unfamiliar with Image Uploader Flash PHP, please, see the Quick Start with Image Uploader Flash PHP topic.

To restore session server-side you need to use restoreSession(), like follows:

PHP
require_once 'ImageUploaderFlashPHP/Utils.class.php';
if (Utils::restoreSession()) {
    //Save files
}
else {
    //Handle the error
}

Using Image Uploader Flash JavaScript API

If you prefer not to use Image Uploader Flash PHP, then you should add cookies to the upload request manually via the Image Uploader Flash JavaScript. To do this, use the metadata.addCustomField(String, String, Boolean) method which accepts cookie in the following format: "cookieName=cookieValue". The most convenient place to call this method is the BeforeUpload event handler, because this event fires when the upload is about to be started.

JavaScript
function beforeUploadHandler(){
    var fu = $au.imageUploaderFlash('Uploader1');
    fu.metadata().addCustomField('PHPSESSID','<?=$_COOKIE["PHPSESSID"]?>',true);
};

var fu = $au.imageUploaderFlash({
    id: 'Uploader1',
    events: {beforeUpload: beforeUploadHandler},
});
fu.writeHtml();

To restore session server-side you need to use restoreSession(), like follows:

PHP
require_once 'ImageUploaderFlashPHP/Utils.class.php';
if (Utils::restoreSession()) {
    //Save files
}
else {
    //Handle the error
}

See Also

Reference

Manual