intial commit

Author: mariusleu

.gitignore

@@ -0,0 +1,4 @@
+/vendor
+composer.phar
+composer.lock
+.DS_Store

.travis.yml

@@ -0,0 +1,12 @@
+language: php
+
+php: 
+  - 5.3
+  - 5.4
+  - 5.5
+
+before_script:
+  - curl -s http://getcomposer.org/installer | php
+  - php composer.phar install --dev
+
+script: phpunit

README.md

@@ -0,0 +1,8 @@
+# File Manager (Laravel Bundle)
+
+This package allows you to manage file uploads (store and deliver) to local server, cdn, and any other storage provider that you want.
+
+
+
+
+

composer.json

@@ -0,0 +1,23 @@
+{
+    "name": "softservlet/file-manager",
+    "description": "",
+    "authors": [
+        {
+            "name": "Softservlet",
+            "email": "[email protected]"
+        }
+    ],
+    "require": {
+        "php": ">=5.3.0",
+        "illuminate/support": "4.1.*"
+    },
+    "autoload": {
+        "classmap": [
+            "src/migrations"
+        ],
+        "psr-0": {
+            "Softservlet\\FileManager\\": "src/"
+        }
+    },
+    "minimum-stability": "dev"
+}

hacking.md

@@ -0,0 +1,26 @@
+### Delivering files
+The file delivery can be used in many ways.
+For example a type of delivery can be though http URL, another can be though storage path, another can be though CDN file ID.
+Any of this string we will call 'URI'.
+
+
+A file can be stored many ways:
+ * file:///var/www/file.ext
+ * http://domain.com/file.ext
+ * foo://domain.com/file.ext
+
+So a file is always stored in a location that matches the following pattern of URI: 
+	
+	<schema>:<locatie>[?<interogarea>][#<fragmentul>] 
+
+For example if we store a file in openstack onbject storage we can have the following uri for it:
+
+	openstackv1://4281c348eaf83e70ddce0e07221c3d28
+
+Each file must have the following attributes:
+
+ * URI
+ * Name
+ * MimeType
+
+

phpunit.xml

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit backupGlobals="false"
+         backupStaticAttributes="false"
+         bootstrap="vendor/autoload.php"
+         colors="true"
+         convertErrorsToExceptions="true"
+         convertNoticesToExceptions="true"
+         convertWarningsToExceptions="true"
+         processIsolation="false"
+         stopOnFailure="false"
+         syntaxCheck="false"
+>
+    <testsuites>
+        <testsuite name="Package Test Suite">
+            <directory suffix=".php">./tests/</directory>
+        </testsuite>
+    </testsuites>
+</phpunit>

public/.gitkeep

@@ -0,0 +1,125 @@
+<?php namespace Softservlet\FileManager\Deliver;
+
+use Exception;
+
+/**
+ * @author Marius Leustean <[email protected]>
+ *
+ * @version 1.0
+ */
+
+class UriParser
+{
+	/**
+	 * @brief the uri to be parsed
+	 *
+	 * @var string
+	 */
+	protected $uri;
+
+	/**
+	 * @brief the uri schema
+	 *
+	 * @var string
+	 */
+	protected $schema;
+
+	/**
+	 * @brief the uri location
+	 *
+	 * @var string
+	 */
+	protected $location;
+
+	/**
+	 * @brief the uri query (after ?)
+	 *
+	 * @var string
+	 */
+	protected $query;
+
+	/**
+	 * @brief uri fragment (after #)
+	 *
+	 * @var fragment
+	 */
+	protected $fragment;
+		
+	/**
+	 * @brief class constructor
+	 *
+	 * @param string $uri to be parsed
+	 */
+	public function __construct($uri)
+	{
+		$this->parseUri($uri);
+	}
+	
+	/**
+	 * @brief get the uri schema
+	 *
+	 * @return string
+	 */
+	public function getSchema()
+	{
+		return $this->schema;
+	}
+
+	/**
+	 * @brief get the uri location part
+	 *
+	 * @return string
+	 */
+	public function getLocation()
+	{
+		return $this->location;
+	}
+
+	/**
+	 * @brief get the uri query string 
+	 *
+	 * @return string
+	 */
+	public function getQuery()
+	{
+		return $this->query;
+	}
+
+	/**
+	 * @brief get the uri fragment part
+	 *
+	 * @return string
+	 */
+	public function getFragment()
+	{
+		return $this->fragment;
+	}
+	/**
+	 * @brief parse the uri into variables
+	 *
+	 * @param uri to be parsed
+	 *
+	 * @return void
+	 */
+	protected function parseUri($uri) 
+	{
+		$split = preg_split('/\:\/{2}|\?|\#/i', $uri);
+
+		if(count($split) <= 2) {
+			throw new Exception(sprintf("The uri [%s] is not valid", $uri));
+		}
+
+		$this->uri = $uri;
+		$this->schema = $split[0];
+		$this->location = $split[1];
+		
+		if(isset($split[2])) {
+			$this->query = $split[2];
+		}
+
+		if(isset($split[3])) {
+			$this->fragment = $split[3];
+		}
+	}
+}
+

src/Softservlet/FileManager/Deliver/UriParser.php

@@ -0,0 +1,39 @@
+<?php namespace Softservlet\FileManager\File;
+
+/**
+ * @author Marius Leustean <[email protected]>
+ *
+ * @version 1.0
+ */
+interface FileDescriptorInterface
+{
+	/**
+	 * @brief return the file mime type
+	 *
+	 * @return string mime type
+	 */
+	public function mime():
+
+	/**
+	 * @brief return the file cintents
+	 *
+	 * @return string/octet-stream the contents of the file
+	 */
+	public function contents();
+
+	/**
+	 * @brief return the size of the file in bytes
+	 *
+	 * @return int size
+	 */
+	public function size();
+
+	/**
+	 * @brief get the file name
+	 *
+	 * @return string
+	 */
+	public function name();
+	
+}
+

src/Softservlet/FileManager/Deliver/UrlInterface.php

@@ -0,0 +1,18 @@
+<?php namespace Softservlet\FileManager\File;
+
+/**
+ * @author Marius Leustean <[email protected]>
+ *
+ * @version 1.0
+ */
+interface FileInterface
+{
+	/**
+	 * @brief get the file URI
+	 *
+	 *
+	 * @return string uri
+	 */
+	public function uri();
+
+}

src/Softservlet/FileManager/File/FileDescriptorInterface.php

@@ -0,0 +1,80 @@
+<?php namespace Softservlet\FileManager\File;
+
+use finfo;
+use Softservlet\FileManager\File\FileInterface;
+use Softservlet\FileManager\Deliver\UriParser;
+
+/**
+ * @author Marius Leustean <[email protected]>
+ *
+ * @version 1.0
+ */
+class LocalFileDescriptor implements FileDescriptorInterface
+{
+	/**
+	 * @brief file object
+	 *
+	 * @var FileInterface 
+	 */
+	protected $file;
+	
+	/**
+	 * @brief file location on the disk
+	 *
+	 * @var string
+	 */
+	protected $location;
+
+
+	public function __construct(FileInterface $file)
+	{
+		$this->file = $file;
+
+		$parser = new UriParser($this->file->uri());
+
+		$this->location = $parser->getLocation();
+	}
+
+
+	/**
+	 * @brief return the file mime type
+	 *
+	 * @return string mime type
+	 */
+	public function mime()
+	{
+		$finfo = new finfo(FILEINFO_MIME_TYPE, $this->location);
+		return $finfo->file($this->location);
+	}
+
+	/**
+	 * @brief return the file cintents
+	 *
+	 * @return string/octet-stream the contents of the file
+	 */
+	public function contents()
+	{
+		return file_get_contents($this->location);
+	}	
+
+	/**
+	 * @brief return the size of the file in bytes
+	 *
+	 * @return int size
+	 */
+	public function size()
+	{
+		return filesize($this->location);
+	}
+
+	/**
+	 * @brief get the file name
+	 *
+	 * @return string
+	 */
+	public function name()
+	{
+		return basename($this->location);
+	}
+
+}