<?php
|
/**
|
* Filesystem Attachments
|
*
|
* This is a core plugin which provides basic, filesystem based
|
* attachment temporary file handling. This includes storing
|
* attachments of messages currently being composed, writing attachments
|
* to disk when drafts with attachments are re-opened and writing
|
* attachments to disk for inline display in current html compositions.
|
*
|
* Developers may wish to extend this class when creating attachment
|
* handler plugins:
|
* require_once('plugins/filesystem_attachments/filesystem_attachments.php');
|
* class myCustom_attachments extends filesystem_attachments
|
*
|
* @author Ziba Scott <ziba@umich.edu>
|
* @author Thomas Bruederli <roundcube@gmail.com>
|
*
|
*/
|
class filesystem_attachments extends rcube_plugin
|
{
|
public $task = 'mail';
|
|
function init()
|
{
|
// Save a newly uploaded attachment
|
$this->add_hook('upload_attachment', array($this, 'upload'));
|
|
// Save an attachment from a non-upload source (draft or forward)
|
$this->add_hook('save_attachment', array($this, 'save'));
|
|
// Remove an attachment from storage
|
$this->add_hook('remove_attachment', array($this, 'remove'));
|
|
// When composing an html message, image attachments may be shown
|
$this->add_hook('display_attachment', array($this, 'display'));
|
|
// Get the attachment from storage and place it on disk to be sent
|
$this->add_hook('get_attachment', array($this, 'get_attachment'));
|
|
// Delete all temp files associated with this user
|
$this->add_hook('cleanup_attachments', array($this, 'cleanup'));
|
$this->add_hook('kill_session', array($this, 'cleanup'));
|
}
|
|
/**
|
* Save a newly uploaded attachment
|
*/
|
function upload($args)
|
{
|
$args['status'] = false;
|
$rcmail = rcmail::get_instance();
|
|
// use common temp dir for file uploads
|
// #1484529: we need absolute path on Windows for move_uploaded_file()
|
$temp_dir = realpath($rcmail->config->get('temp_dir'));
|
$tmpfname = tempnam($temp_dir, 'rcmAttmnt');
|
|
if (move_uploaded_file($args['path'], $tmpfname) && file_exists($tmpfname)) {
|
$args['id'] = $this->file_id();
|
$args['path'] = $tmpfname;
|
$args['status'] = true;
|
|
// Note the file for later cleanup
|
$_SESSION['plugins']['filesystem_attachments']['tmp_files'][] = $tmpfname;
|
}
|
|
return $args;
|
}
|
|
/**
|
* Save an attachment from a non-upload source (draft or forward)
|
*/
|
function save($args)
|
{
|
$args['status'] = false;
|
|
if (!$args['path']) {
|
$rcmail = rcmail::get_instance();
|
$temp_dir = unslashify($rcmail->config->get('temp_dir'));
|
$tmp_path = tempnam($temp_dir, 'rcmAttmnt');
|
|
if ($fp = fopen($tmp_path, 'w')) {
|
fwrite($fp, $args['data']);
|
fclose($fp);
|
$args['path'] = $tmp_path;
|
} else
|
return $args;
|
}
|
|
$args['id'] = $this->file_id();
|
$args['status'] = true;
|
|
// Note the file for later cleanup
|
$_SESSION['plugins']['filesystem_attachments']['tmp_files'][] = $args['path'];
|
|
return $args;
|
}
|
|
/**
|
* Remove an attachment from storage
|
* This is triggered by the remove attachment button on the compose screen
|
*/
|
function remove($args)
|
{
|
$args['status'] = @unlink($args['path']);
|
return $args;
|
}
|
|
/**
|
* When composing an html message, image attachments may be shown
|
* For this plugin, the file is already in place, just check for
|
* the existance of the proper metadata
|
*/
|
function display($args)
|
{
|
$args['status'] = file_exists($args['path']);
|
return $args;
|
}
|
|
/**
|
* This attachment plugin doesn't require any steps to put the file
|
* on disk for use. This stub function is kept here to make this
|
* class handy as a parent class for other plugins which may need it.
|
*/
|
function get_attachment($args)
|
{
|
return $args;
|
}
|
|
/**
|
* Delete all temp files associated with this user
|
*/
|
function cleanup($args)
|
{
|
// $_SESSION['compose']['attachments'] is not a complete record of
|
// temporary files because loading a draft or starting a forward copies
|
// the file to disk, but does not make an entry in that array
|
if (is_array($_SESSION['plugins']['filesystem_attachments']['tmp_files'])){
|
foreach ($_SESSION['plugins']['filesystem_attachments']['tmp_files'] as $filename){
|
if(file_exists($filename)){
|
unlink($filename);
|
}
|
}
|
unset($_SESSION['plugins']['filesystem_attachments']['tmp_files']);
|
}
|
return $args;
|
}
|
|
function file_id()
|
{
|
$userid = rcmail::get_instance()->user->ID;
|
list($usec, $sec) = explode(' ', microtime());
|
return preg_replace('/[^0-9]/', '', $userid . $sec . $usec);
|
}
|
}
|
