ILIAS  release_5-2 Revision v5.2.25-18-g3f80b828510
Public Member Functions | Data Fields | Protected Member Functions
ilRestFileStorage Class Reference

File storage handling. More...

+ Inheritance diagram for ilRestFileStorage:
+ Collaboration diagram for ilRestFileStorage:

Public Member Functions

 __construct ()
 Constructor. More...
 
 getFile ($name)
 Get file by md5 hash. More...
 
 createFile ()
 Get file by md5 hash. More...
 
 storeFileForRest ($content)
 
 getStoredFilePath ($tmpname)
 
 deleteDeprecated ()
 Delete deprecated files. More...
 
- Public Member Functions inherited from ilFileSystemStorage
 __construct ($a_storage_type, $a_path_conversion, $a_container_id)
 Constructor. More...
 
 getContainerId ()
 
 create ()
 Create directory. More...
 
 getAbsolutePath ()
 Get absolute path of storage directory. More...
 
 writeToFile ($a_data, $a_absolute_path)
 Write data to file. More...
 
 deleteFile ($a_abs_name)
 Delete file. More...
 
 deleteDirectory ($a_abs_name)
 Delete directory. More...
 
 delete ()
 Delete complete directory. More...
 
 copyFile ($a_from, $a_to)
 Copy files. More...
 
 appendToPath ($a_appendix)
 
 getStorageType ()
 
 getPath ()
 Get path. More...
 
 __construct ($a_storage_type, $a_path_conversion, $a_container_id)
 Constructor. More...
 
 create ()
 Create directory. More...
 
 getAbsolutePath ()
 Get absolute path of storage directory. More...
 
 getShortPath ()
 
 rename ($from, $to)
 

Data Fields

const AVAILABILITY_IN_DAYS = 1
 
- Data Fields inherited from ilFileSystemStorage
const STORAGE_WEB = 1
 
const STORAGE_DATA = 2
 
const STORAGE_SECURED = 3
 
const FACTOR = 100
 
const MAX_EXPONENT = 3
 
const SECURED_DIRECTORY = "sec"
 

Protected Member Functions

 checkWebserviceActivation ()
 Check if soap administration is enabled. More...
 
 getPathPrefix ()
 Get path prefix. More...
 
 getPathPostfix ()
 Get path prefix. More...
 
 init ()
 init and create directory More...
 
 responeNotFound ()
 Send not found response. More...
 
- Protected Member Functions inherited from ilFileSystemStorage
 getPathPrefix ()
 Get path prefix. More...
 
 getPathPostfix ()
 Get directory name. More...
 
 init ()
 Read path info. More...
 
 getPathPrefix ()
 Get path prefix. More...
 
 getPathPostfix ()
 Get directory name. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from ilFileSystemStorage
static _createPathFromId ($a_container_id, $a_name)
 Create a path from an id: e.g 12345 will be converted to 12/34/<name>_5. More...
 
static _copyDirectory ($a_source, $a_target)
 Copy directory and all contents. More...
 
static _createPathFromId ($a_container_id, $a_name)
 Create a path from an id: e.g 12345 will be converted to 12/34/<name>_5. More...
 
- Protected Attributes inherited from ilFileSystemStorage
 $path
 

Detailed Description

File storage handling.

Author
Stefan Meyer smeye.nosp@m.r.il.nosp@m.ias@g.nosp@m.mx.d.nosp@m.e $Id$

Definition at line 12 of file class.ilRestFileStorage.php.

Constructor & Destructor Documentation

◆ __construct()

ilRestFileStorage::__construct ( )

Constructor.

Definition at line 20 of file class.ilRestFileStorage.php.

References ilFileSystemStorage\STORAGE_DATA.

21  {
22  parent::__construct(
23  ilFileSystemStorage::STORAGE_DATA,
24  false,
25  0
26  );
27  }

Member Function Documentation

◆ checkWebserviceActivation()

ilRestFileStorage::checkWebserviceActivation ( )
protected

Check if soap administration is enabled.

Definition at line 32 of file class.ilRestFileStorage.php.

References $GLOBALS, and Slim\getInstance().

Referenced by createFile(), and getFile().

33  {
34  $settings = $GLOBALS['ilSetting'];
35  if(!$settings->get('soap_user_administration',0))
36  {
37  Slim::getInstance()->response()->header('Content-Type','text/html');
38  Slim::getInstance()->response()->status(403);
39  Slim::getInstance()->response()->body('Webservices not enabled.');
40  return false;
41  }
42  return true;
43  }
Slim\getInstance
static getInstance( $name='default')
Get Slim application with name.
Definition: Slim.php:254
$GLOBALS
$GLOBALS['loaded']
Global hash that tracks already loaded includes.
Definition: generate-standalone.php:18
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ createFile()

ilRestFileStorage::createFile ( )

Get file by md5 hash.

Parameters
<type>$name

Definition at line 125 of file class.ilRestFileStorage.php.

References $GLOBALS, ilFileSystemStorage\$path, checkWebserviceActivation(), Slim\getInstance(), ilFileSystemStorage\getPath(), ilUtil\ilTempnam(), and ilFileSystemStorage\writeToFile().

126  {
127  if(!$this->checkWebserviceActivation())
128  {
129  return false;
130  }
131 
132  $request = Slim::getInstance()->request();
133  $body = $request->post("content");
134 
135  $tmpname = ilUtil::ilTempnam();
136  $path = $this->getPath().'/'.basename($tmpname);
137 
138  $this->writeToFile($body, $path);
139  $return = basename($tmpname);
140 
141  $GLOBALS['ilLog']->write(__METHOD__.' Writing to path '.$path);
142 
143  Slim::getInstance()->response()->header('Content-Type', 'application/json');
144  Slim::getInstance()->response()->body($return);
145  }
Slim\getInstance
static getInstance( $name='default')
Get Slim application with name.
Definition: Slim.php:254
$GLOBALS
$GLOBALS['loaded']
Global hash that tracks already loaded includes.
Definition: generate-standalone.php:18
ilFileSystemStorage\writeToFile
writeToFile($a_data, $a_absolute_path)
Write data to file.
Definition: class.ilFileSystemStorage.php:203
ilUtil\ilTempnam
static ilTempnam($a_temp_path=null)
Create a temporary file in an ILIAS writable directory.
Definition: class.ilUtil.php:1696
ilRestFileStorage\checkWebserviceActivation
checkWebserviceActivation()
Check if soap administration is enabled.
Definition: class.ilRestFileStorage.php:32
+ Here is the call graph for this function:

◆ deleteDeprecated()

ilRestFileStorage::deleteDeprecated ( )

Delete deprecated files.

Definition at line 164 of file class.ilRestFileStorage.php.

References $file, $GLOBALS, ilFileSystemStorage\getPath(), and time.

165  {
166  $max_age = time() - self::AVAILABILITY_IN_DAYS * 24 * 60 * 60;
167  $ite = new DirectoryIterator($this->getPath());
168  foreach($ite as $file)
169  {
170  if($file->getCTime() <= $max_age)
171  {
172  try {
173  @unlink($file->getPathname());
174  }
175  catch(Exception $e) {
176  $GLOBALS['ilLog']->write(__METHOD__.' '. $e->getMessage());
177  }
178  }
179  }
180  }
$GLOBALS
$GLOBALS['loaded']
Global hash that tracks already loaded includes.
Definition: generate-standalone.php:18
time
Add data(end) time
Method that wraps PHPs time in order to allow simulations with the workflow.
Definition: 40duplicateStyle.php:39
$file
if(!file_exists("$old.txt")) if($old===$new) if(file_exists("$new.txt")) $file
Definition: rename-config.php:43
+ Here is the call graph for this function:

◆ getFile()

ilRestFileStorage::getFile (   $name)

Get file by md5 hash.

Parameters
<type>$name

Definition at line 74 of file class.ilRestFileStorage.php.

References $GLOBALS, $real_path, checkWebserviceActivation(), Slim\getInstance(), ilFileSystemStorage\getPath(), and responeNotFound().

75  {
76  if(!$this->checkWebserviceActivation())
77  {
78  return false;
79  }
80 
81  $GLOBALS['ilLog']->write(__METHOD__.' original name: '.$this->getPath().'/'.$name);
82 
83  $real_path = realpath($this->getPath().'/'.$name);
84  if(!$real_path)
85  {
86  $GLOBALS['ilLog']->write(__METHOD__.' no realpath found for: '.$this->getPath().'/'.$name);
87  $this->responeNotFound();
88  return;
89  }
90  $file_name = basename($real_path);
91  $GLOBALS['ilLog']->write(__METHOD__.' translated name: '.$this->getPath().'/'.$file_name);
92  if(
93  $file_name &&
94  is_file($this->getPath().'/'.$file_name) &&
95  file_exists($this->getPath().'/'.$file_name)
96  )
97  {
98  $GLOBALS['ilLog']->write(__METHOD__.' delivering file: ' . $this->getPath().'/'.$file_name);
99  $return = file_get_contents($this->getPath().'/'.$file_name);
100  // Response header
101  Slim::getInstance()->response()->header('Content-Type', 'application/json');
102  Slim::getInstance()->response()->body($return);
103  return;
104  }
105 
106  $this->responeNotFound();
107  }
Slim\getInstance
static getInstance( $name='default')
Get Slim application with name.
Definition: Slim.php:254
$GLOBALS
$GLOBALS['loaded']
Global hash that tracks already loaded includes.
Definition: generate-standalone.php:18
$real_path
$real_path
Definition: aliased.php:29
ilRestFileStorage\responeNotFound
responeNotFound()
Send not found response.
Definition: class.ilRestFileStorage.php:113
ilRestFileStorage\checkWebserviceActivation
checkWebserviceActivation()
Check if soap administration is enabled.
Definition: class.ilRestFileStorage.php:32
+ Here is the call graph for this function:

◆ getPathPostfix()

ilRestFileStorage::getPathPostfix ( )
protected

Get path prefix.

Definition at line 56 of file class.ilRestFileStorage.php.

57  {
58  return 'files';
59  }

◆ getPathPrefix()

ilRestFileStorage::getPathPrefix ( )
protected

Get path prefix.

Definition at line 48 of file class.ilRestFileStorage.php.

49  {
50  return 'ilRestFileStorage';
51  }

◆ getStoredFilePath()

ilRestFileStorage::getStoredFilePath (   $tmpname)

Definition at line 156 of file class.ilRestFileStorage.php.

References ilFileSystemStorage\getPath().

157  {
158  return $this->getPath().'/'.$tmpname;
159  }
+ Here is the call graph for this function:

◆ init()

ilRestFileStorage::init ( )
protected

init and create directory

Definition at line 64 of file class.ilRestFileStorage.php.

References ilFileSystemStorage\create().

65  {
66  parent::init();
67  $this->create();
68  }
+ Here is the call graph for this function:

◆ responeNotFound()

ilRestFileStorage::responeNotFound ( )
protected

Send not found response.

Definition at line 113 of file class.ilRestFileStorage.php.

References $GLOBALS, and Slim\getInstance().

Referenced by getFile().

114  {
115  $GLOBALS['ilLog']->write(__METHOD__.' file not found.');
116  Slim::getInstance()->response()->header('Content-Type','text/html');
117  Slim::getInstance()->response()->status(404);
118  Slim::getInstance()->response()->body('Not found');
119  }
Slim\getInstance
static getInstance( $name='default')
Get Slim application with name.
Definition: Slim.php:254
$GLOBALS
$GLOBALS['loaded']
Global hash that tracks already loaded includes.
Definition: generate-standalone.php:18
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ storeFileForRest()

ilRestFileStorage::storeFileForRest (   $content)

Definition at line 147 of file class.ilRestFileStorage.php.

References ilFileSystemStorage\$path, ilFileSystemStorage\getPath(), ilUtil\ilTempnam(), and ilFileSystemStorage\writeToFile().

148  {
149  $tmpname = ilUtil::ilTempnam();
150  $path = $this->getPath().'/'.basename($tmpname);
151 
152  $this->writeToFile($content, $path);
153  return basename($tmpname);
154  }
ilFileSystemStorage\writeToFile
writeToFile($a_data, $a_absolute_path)
Write data to file.
Definition: class.ilFileSystemStorage.php:203
ilUtil\ilTempnam
static ilTempnam($a_temp_path=null)
Create a temporary file in an ILIAS writable directory.
Definition: class.ilUtil.php:1696
+ Here is the call graph for this function:

Field Documentation

◆ AVAILABILITY_IN_DAYS

const ilRestFileStorage::AVAILABILITY_IN_DAYS = 1

Definition at line 14 of file class.ilRestFileStorage.php.

The documentation for this class was generated from the following file: