Additional doc blocks, added private_uploads path

app/Http/Controllers/AccessoriesController.php

@@ -5,7 +5,7 @@
  *
  * PHP version 5.5.9
  * @package    Snipe-IT
- * @version    v3.0
+ * @version    v1.0
  */
 
 namespace App\Http\Controllers;

app/Http/Controllers/AssetMaintenancesController.php

@@ -1,26 +1,34 @@
 <?php
+/**
+ * This controller handles all actions related to Asset Maintenance for
+ * the Snipe-IT Asset Management application.
+ *
+ * PHP version 5.5.9
+ * @package    Snipe-IT
+ * @version    v2.0
+ */
 
-    namespace App\Http\Controllers;
+namespace App\Http\Controllers;
 
-    use App\Models\AssetMaintenance;
-    use Carbon\Carbon;
-    use App\Models\Company;
-    use DB;
-    use Input;
-    use Lang;
-    use Log;
-    use Mail;
-    use Redirect;
-    use Response;
-    use Slack;
-    use Str;
-    use App\Models\Supplier;
-    use TCPDF;
-    use Validator;
-    use View;
-    use App\Models\Setting;
-    use App\Models\Asset;
-    use App\Helpers\Helper;
+use App\Models\AssetMaintenance;
+use Carbon\Carbon;
+use App\Models\Company;
+use DB;
+use Input;
+use Lang;
+use Log;
+use Mail;
+use Redirect;
+use Response;
+use Slack;
+use Str;
+use App\Models\Supplier;
+use TCPDF;
+use Validator;
+use View;
+use App\Models\Setting;
+use App\Models\Asset;
+use App\Helpers\Helper;
 
 class AssetMaintenancesController extends Controller
 {
@@ -30,13 +38,13 @@ class AssetMaintenancesController extends Controller
           ->with('error', Lang::get('general.insufficient_permissions'));
     }
 
-  /**
-       * getIndex
-       *
-       * @return mixed
-       * @author  Vincent Sposato <vincent.sposato@gmail.com>
-       * @version v1.0
-       */
+    /**
+    * getIndex
+    *
+    * @return mixed
+    * @author  Vincent Sposato <vincent.sposato@gmail.com>
+    * @version v1.0
+    */
     public function getIndex()
     {
 

app/Http/Controllers/AssetsController.php

@@ -734,7 +734,7 @@ class AssetsController extends Controller
     public function getImportUpload()
     {
 
-        $path = storage_path().'/app/private_uploads/imports/assets';
+        $path = config('app.private_uploads').'/imports/assets';
         $files = array();
 
         if (!Company::isCurrentUserAuthorized()) {
@@ -780,7 +780,7 @@ class AssetsController extends Controller
         } elseif (!config('app.lock_passwords')) {
 
             $files = Input::file('files');
-            $path = storage_path().'/app/private_uploads/imports/assets';
+            $path = config('app.private_uploads').'/imports/assets';
             $results = array();
 
             foreach ($files as $file) {
@@ -838,9 +838,9 @@ class AssetsController extends Controller
         }
 
         $output = new BufferedOutput;
-        Artisan::call('asset-import:csv', ['filename'=> storage_path().'/app/private_uploads/imports/assets/'.$filename, '--email_format'=>'firstname.lastname', '--username_format'=>'firstname.lastname'], $output);
+        Artisan::call('asset-import:csv', ['filename'=> config('app.private_uploads').'/imports/assets/'.$filename, '--email_format'=>'firstname.lastname', '--username_format'=>'firstname.lastname'], $output);
         $display_output =  $output->fetch();
-        $file = storage_path().'/app/private_uploads/imports/assets/'.str_replace('.csv', '', $filename).'-output-'.date("Y-m-d-his").'.txt';
+        $file = config('app.private_uploads').'/imports/assets/'.str_replace('.csv', '', $filename).'-output-'.date("Y-m-d-his").'.txt';
         file_put_contents($file, $display_output);
 
 
@@ -948,7 +948,7 @@ class AssetsController extends Controller
         }
 
         // the asset is valid
-        $destinationPath = storage_path().'/private_uploads/app/imports/assets';
+        $destinationPath = config('app.private_uploads').'/imports/assets';
 
 
 
@@ -1001,7 +1001,7 @@ class AssetsController extends Controller
     public function getDeleteFile($assetId = null, $fileId = null)
     {
         $asset = Asset::find($assetId);
-        $destinationPath = storage_path().'private_uploads/app/imports/assets';
+        $destinationPath = config('app.private_uploads').'/imports/assets';
 
         // the asset is valid
         if (isset($asset->id)) {

app/Http/Controllers/CategoriesController.php

@@ -1,4 +1,13 @@
-<?php namespace App\Http\Controllers;
+<?php
+/**
+ * This controller handles all actions related to Asset Categories for
+ * the Snipe-IT Asset Management application.
+ *
+ * PHP version 5.5.9
+ * @package    Snipe-IT
+ * @version    v1.0
+ */
+namespace App\Http\Controllers;
 
 use App\Helpers\Helper;
 use App\Models\Category as Category;

app/Http/Controllers/ChangeEmailController.php

@@ -1,4 +1,12 @@
 <?php
+/**
+ * This controller handles all actions for users changing their email address in their profile
+ *  for the Snipe-IT Asset Management application.
+ *
+ * PHP version 5.5.9
+ * @package    Snipe-IT
+ * @version    v1.0
+ */
 namespace App\Http\Controllers;
 
 use Input;

app/Http/Controllers/ChangePasswordController.php

@@ -1,4 +1,12 @@
 <?php
+/**
+ * This controller handles all actions related to users changing
+ * their passwords in the Snipe-IT Asset Management application.
+ *
+ * PHP version 5.5.9
+ * @package    Snipe-IT
+ * @version    v1.0
+ */
 namespace App\Http\Controllers;
 
 use Input;

app/Http/Controllers/CompaniesController.php

@@ -1,4 +1,13 @@
-<?php namespace App\Http\Controllers;
+<?php
+/**
+ * This controller handles all actions related to Company support for
+ * the Snipe-IT Asset Management application.
+ *
+ * PHP version 5.5.9
+ * @package    Snipe-IT
+ * @version    v2.0
+ */
+ namespace App\Http\Controllers;
 
 use App\Models\Company;
 use Input;

app/Http/Controllers/ComponentsController.php

@@ -1,4 +1,13 @@
-<?php namespace App\Http\Controllers;
+<?php
+/**
+ * This controller handles all actions related to Asset Models for
+ * the Snipe-IT Asset Management application.
+ *
+ * PHP version 5.5.9
+ * @package    Snipe-IT
+ * @version    v1.0
+ */
+ namespace App\Http\Controllers;
 
 use App\Helpers\Helper;
 use App\Models\Actionlog;

app/Http/Controllers/ConsumablesController.php

@@ -1,4 +1,13 @@
-<?php namespace App\Http\Controllers;
+<?php
+/**
+ * This controller handles all actions related to Consumables for
+ * the Snipe-IT Asset Management application.
+ *
+ * PHP version 5.5.9
+ * @package    Snipe-IT
+ * @version    v1.8
+ */
+ namespace App\Http\Controllers;
 
 use App\Helpers\Helper;
 use App\Models\Actionlog;

app/Http/Controllers/CustomFieldsController.php

@@ -1,4 +1,12 @@
 <?php
+/**
+ * This controller handles all actions related to Custom Asset Fields for
+ * the Snipe-IT Asset Management application.
+ *
+ * PHP version 5.5.9
+ * @package    Snipe-IT
+ * @version    v2.0
+ */
 namespace App\Http\Controllers;
 
 use View;

app/Http/Controllers/DashboardController.php

@@ -1,4 +1,12 @@
 <?php
+/**
+ * This controller handles all actions related to the admin dashboard
+ * the Snipe-IT Asset Management application.
+ *
+ * PHP version 5.5.9
+ * @package    Snipe-IT
+ * @version    v1.0
+ */
 namespace App\Http\Controllers;
 
 use App\Http\Controllers\AdminController;

app/Http/Controllers/DepreciationsController.php

@@ -1,4 +1,12 @@
 <?php
+/**
+ * This controller handles all actions related to Asset Depreciation
+ * for the Snipe-IT Asset Management application.
+ *
+ * PHP version 5.5.9
+ * @package    Snipe-IT
+ * @version    v1.0
+ */
 namespace App\Http\Controllers;
 
 use Input;

app/Http/Controllers/GroupsController.php

@@ -1,4 +1,12 @@
 <?php
+/**
+ * This controller handles all actions related to User Groups for
+ * the Snipe-IT Asset Management application.
+ *
+ * PHP version 5.5.9
+ * @package    Snipe-IT
+ * @version    v1.0
+ */
 namespace App\Http\Controllers;
 
 use Config;

app/Http/Controllers/LicensesController.php

@@ -1,4 +1,13 @@
 <?php
+/**
+ * This controller handles all actions related to Licenses and
+ * License Seats for the Snipe-IT Asset Management application.
+ *
+ * PHP version 5.5.9
+ * @package    Snipe-IT
+ * @version    v1.0
+ */
+
 namespace App\Http\Controllers;
 
 use Assets;
@@ -790,7 +799,7 @@ class LicensesController extends Controller
         $license = License::find($licenseId);
 
         // the license is valid
-        $destinationPath = storage_path().'/app/private_uploads';
+        $destinationPath = config('app.private_uploads').'/licenses';
 
         if (isset($license->id)) {
 
@@ -866,7 +875,7 @@ class LicensesController extends Controller
     public function getDeleteFile($licenseId = null, $fileId = null)
     {
         $license = License::find($licenseId);
-        $destinationPath = storage_path().'/app/private_uploads';
+        $destinationPath = config('app.private_uploads').'/licenses';
 
         // the license is valid
         if (isset($license->id)) {

app/Http/Controllers/LocationsController.php

@@ -1,4 +1,13 @@
 <?php
+/**
+ * This controller handles all actions related to Locations for
+ * the Snipe-IT Asset Management application.
+ *
+ * PHP version 5.5.9
+ * @package    Snipe-IT
+ * @version    v1.0
+ */
+
 namespace App\Http\Controllers;
 
 use Input;

app/Http/Controllers/ManufacturersController.php

@@ -1,4 +1,12 @@
 <?php
+/**
+ * This controller handles all actions related to Manufacturers for
+ * the Snipe-IT Asset Management application.
+ *
+ * PHP version 5.5.9
+ * @package    Snipe-IT
+ * @version    v1.0
+ */
 namespace App\Http\Controllers;
 
 use App\Models\Company;

app/Http/Controllers/ProfileController.php

@@ -1,4 +1,13 @@
 <?php
+/**
+ * This controller handles user profile editing 
+ * the Snipe-IT Asset Management application.
+ *
+ * PHP version 5.5.9
+ * @package    Snipe-IT
+ * @version    v1.0
+ */
+
 namespace App\Http\Controllers;
 
 use Image;

app/Http/Controllers/ReportsController.php

@@ -1,4 +1,13 @@
 <?php
+/**
+ * This controller handles all reporting actions for
+ * the Snipe-IT Asset Management application.
+ *
+ * PHP version 5.5.9
+ * @package    Snipe-IT
+ * @version    v1.0
+ */
+
 namespace App\Http\Controllers;
 
 use App\Models\Accessory;

app/Http/Controllers/SettingsController.php

@@ -421,7 +421,9 @@ class SettingsController extends Controller
     */
     public function getBackups()
     {
-        $path = storage_path().'/app/'.config('laravel-backup.destination.path');
+
+        $path = config('app.private_uploads').'/backups';
+
         $files = array();
 
         if ($handle = opendir($path)) {
@@ -479,7 +481,7 @@ class SettingsController extends Controller
     public function downloadFile($filename = null)
     {
         if (!config('app.lock_passwords')) {
-            $path = storage_path().'/app/'.config('laravel-backup.destination.path');
+            $path = config('app.private_uploads').'/backups';
             $file = $path.'/'.$filename;
             if (file_exists($file)) {
                 return Response::download($file);

app/Http/Controllers/StatuslabelsController.php

@@ -1,4 +1,13 @@
 <?php
+/**
+ * This controller handles all actions related to Status Labels for
+ * the Snipe-IT Asset Management application.
+ *
+ * PHP version 5.5.9
+ * @package    Snipe-IT
+ * @version    v1.0
+ */
+
 namespace App\Http\Controllers;
 
 use Input;

app/Http/Controllers/SuppliersController.php

@@ -1,4 +1,13 @@
 <?php
+/**
+ * This controller handles all actions related to Suppliers for
+ * the Snipe-IT Asset Management application.
+ *
+ * PHP version 5.5.9
+ * @package    Snipe-IT
+ * @version    v1.0
+ */
+
 namespace App\Http\Controllers;
 
 use Image;

app/Http/Controllers/UsersController.php

@@ -938,7 +938,7 @@ class UsersController extends Controller
 
 
         $user = User::find($userId);
-        $destinationPath = storage_path() . '/app/private_uploads/users';
+        $destinationPath = config('app.private_uploads') . '/users';
 
         if (isset($user->id)) {
 
@@ -986,7 +986,7 @@ class UsersController extends Controller
     public function getDeleteFile($userId = null, $fileId = null)
     {
         $user = User::find($userId);
-        $destinationPath = app_path() . '/private_uploads';
+        $destinationPath = config('app.private_uploads').'/users';
 
         // the license is valid
         if (isset($user->id)) {

app/Http/Controllers/ViewAssetsController.php

@@ -1,4 +1,14 @@
 <?php
+/**
+ * This controller handles all actions that allow a logged in user
+ * to view the assets assigned to them (and request an asset) for 
+ * the Snipe-IT Asset Management application.
+ *
+ * PHP version 5.5.9
+ * @package    Snipe-IT
+ * @version    v1.0
+ */
+
 namespace App\Http\Controllers;
 
 use App\Models\Accessory;

config/app.php

@@ -111,13 +111,29 @@ return [
     'log' => env('APP_LOG', 'single'),
 
 
+    /*
+    |--------------------------------------------------------------------------
+    | Default Storage path for private uploads
+    |--------------------------------------------------------------------------
+    | This is the path for any uploaded files that have to be run through the
+    | auth system to ensure they are not visible to the public. These should be
+    | stored somewhere outside of the web root so that an unautenticated user
+    | cannot access them.
+    |
+    | For example: license keys, contracts, etc.
+    |
+    */
+
+    'private_uploads' => storage_path().'/private_uploads',
+
+
     /*
     |--------------------------------------------------------------------------
     | Demo Mode Lockdown
     |--------------------------------------------------------------------------
     |
     | Normal users will never need to edit this. This option lets you run a
-    | version of Snipe-IT with limited functionality to prevent demo abuse. 
+    | version of Snipe-IT with limited functionality to prevent demo abuse.
     |
     */
 

storage/private_uploads/backups/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore