ARK2/Files - Revision history

John Layt: /* File Management */

2017-04-29T15:51:27Z

‎File Management

John Layt at 15:16, 13 February 2017

2017-02-13T15:16:51Z

John Layt: /* File Management */

2016-11-21T09:06:14Z

‎File Management

John Layt at 14:36, 17 November 2016

2016-11-17T14:36:37Z

John Layt: /* Design Work */

2016-11-16T23:35:43Z

‎Design Work

John Layt: /* File Management */

2016-11-16T20:01:43Z

‎File Management

John Layt: /* File Management */

2016-11-16T19:52:37Z

‎File Management

John Layt: /* File Management */

2016-11-16T19:51:30Z

‎File Management

John Layt: /* File Management */

2016-11-16T19:31:42Z

‎File Management

John Layt: /* File Management */

2016-11-16T19:00:45Z

‎File Management

@@ Line 6: / Line 6: @@
 * The file system is abstracted using [http://flysystem.thephpleague.com/ FlySystem] allowing files to be transparently saved locally or to cloud providers.
 * File versioning is supported.
-* Image manipulation is abstracted using Glide and [https://github.com/avalanche123/Imagine Imagine] which supports ImageMagick or GD.
+* Image manipulation is abstracted using [http://glide.thephpleague.com/ Glide] and [https://github.com/avalanche123/Imagine Imagine] which supports ImageMagick or GD.
 * Thumbnails are stored separately from the master files to make backups, archiving, and regeneration easier
 * Multiple thumbnail profiles can be configured
@@ Line 32: / Line 32: @@
        |- <mediatype>
           |- <tokens>
-    |- thumbs
+    |- cache
        |- <profile>
           |- <mediatype>
@@ Line 41: / Line 41: @@
 The individual file names will be in a standard format. Flysystem abstracts folders and file names as a relative path, which will take the form:
   files/data/<mediatype>/<token>/<id>.<revision>.<suffix>
-  files/thumbs/<profile>/<mediatype>/<token>/<id>.<revision>.<suffix>
+  files/cache/<profile>/<mediatype>/<token>/<id>.<revision>.<suffix>
 There will be no direct file or image links, all files are considered private and requests to the mapped URL will be security checked. The mapped URL forms will be:
@@ Line 48: / Line 48: @@
 A custom Flysystem manager is provided that allows different filesystems to be transparently mounted at different points in the file path. For example, the root files/ path is mounted locally, but files/data/ is mounted on Amazon S3.
 == Design Work ==

@@ Line 6: / Line 6: @@
 * The file system is abstracted using [http://flysystem.thephpleague.com/ FlySystem] allowing files to be transparently saved locally or to cloud providers.
 * File versioning is supported.
-* Image manipulation is abstracted using [https://github.com/avalanche123/Imagine Imagine] which supports ImageMagick or GD.
+* Image manipulation is abstracted using Glide and [https://github.com/avalanche123/Imagine Imagine] which supports ImageMagick or GD.
 * Thumbnails are stored separately from the master files to make backups, archiving, and regeneration easier
 * Multiple thumbnail profiles can be configured

@@ Line 24: / Line 24: @@
   - files
     |- download
     |- upload
     |- tmp
     |- data
        |- <mediatype>

@@ Line 11: / Line 11: @@
 * Thumbnails will be generated asynchronously, so can either be queued for batch processing, delayed until a suitable time window, or only generated when needed.
-The Media Types and File Types supported are configurable, with standard types provided by default:
+The Media Types and File Types supported are configurable, with the [https://www.iana.org/assignments/media-types/media-types.xhtml IANA standard types] provided by default:
 * Image (jpg, png, etc)
 * Audio (mp3, etc)
 * Video (mkv, etc)
 * Text (txt, etc)
-* Document / Application (pdf, odt, ods, etc)
+* Application (pdf, odt, ods, etc)
 In multi-tenant mode, the files for each ARK instance are stored separately under the 'sites' folder, e.g. 'sites/mysite/files'.
@@ Line 36: / Line 34: @@
               |- <tokens>
-where the <mediattype> is as defined in the configuration, and the <token> is a configurable token to split the folders into manageable sizes. By default the <token> will be split by file id in groups of 1000, so subfolders for 0, 1000, 2000, 3000, etc.
+where the <mediatype> is as defined in the configuration, and the <token> is a configurable token to split the folders into manageable sizes. By default the <token> will be split by file id in groups of 1000, so subfolders for 0, 1000, 2000, 3000, etc.
 The individual file names will be in a standard format. Flysystem abstracts folders and file names as a relative path, which will take the form:

@@ Line 50: / Line 50: @@
 == Design Work ==
 * Data downloads / exports
-* Documentation
+* Documentation files
-* Temp files
+* Temp files with expiry
 * Mapping files
 Very similar to http://documentation.concrete5.org/developers/working-with-files-and-the-file-manager/overview

@@ Line 45: / Line 45: @@
   files/<id>/<name>
   files/<id>/<basename>_<profile>.<suffix>
 == Design Work ==