d3yii2 / d3files
Extension for file uploading and attaching to the models
Requires
- php: >=5.4.0
- d3yii2/d3system: *
- d3yii2/pdfobject: *
- kartik-v/yii2-widget-fileinput: dev-master
- yiisoft/yii2: ~2.0.0
- yiisoft/yii2-bootstrap: @dev
- dev-master
- 20191013.x-dev
- 0.9.98
- 0.9.97
- 0.9.96
- 0.9.95
- 0.9.94
- 0.9.93
- 0.9.92
- 0.9.91
- 0.9.90
- 0.9.89
- 0.9.87
- 0.9.86
- 0.9.85
- 0.9.84
- 0.9.83
- 0.9.82
- 0.9.81
- 0.9.80
- 0.9.79
- 0.9.78
- 0.9.77
- 0.9.76
- 0.9.75
- 0.9.74
- 0.9.73
- 0.9.72
- 0.9.71
- 0.9.70
- 0.9.69
- 0.9.68
- 0.9.67
- 0.9.66
- 0.9.65
- 0.9.64
- 0.9.63
- 0.9.62
- 0.9.61
- 0.9.60
- 0.9.59
- 0.9.58
- 0.9.57
- 0.9.56
- 0.9.55
- 0.9.54
- 0.9.53
- 0.9.52
- 0.9.51
- 0.9.50
- 0.9.49
- 0.9.48
- 0.9.47
- 0.9.46
- 0.9.45
- 0.9.44
- 0.9.43
- 0.9.42
- 0.9.41
- 0.9.40
- 0.9.38
- 0.9.37
- 0.9.36
- 0.9.35
- 0.9.34
- 0.9.33
- 0.9.32
- 0.9.31
- 0.9.30
- 0.9.29
- 0.9.28
- 0.9.27
- 0.9.26
- 0.9.25
- 0.9.24
- 0.9.23
- 0.9.22
- 0.9.21
- 0.9.20
- 0.9.19
- 0.9.18-alpha
- 0.9.17
- 0.9.16
- 0.9.15
- 0.9.14
- 0.9.13
- 0.9.12
- 0.9.11
- 0.9.10
- 0.9.9
- 0.9.8
- 0.9.7
- 0.9.6
- 0.9.5
- 0.9.4
- 0.9.3
- 0.9.1
- 0.9.0
- dev-argon
- dev-file-extension-bug
- dev-multidirectory
- dev-test
- dev-Fix20200724
- dev-feature/download-from-url-action
- dev-ActionButton
- dev-DixBugForAdditionalButtons
- dev-directory-structures
- dev-unFix20200116
- dev-SaveContent
- dev-bug0_9_29_a
- dev-AddedTyCatch
This package is auto-updated.
Last update: 2024-11-10 19:15:30 UTC
README
Extension for file uploading and attaching to the models
Features
- attach files to model record (it is possible to attach to one model multiple files)
- widget for model view
- access rights realised as standalone actions (separate download, upload, delete) by integrating in model's controllers
- shared files for public access
Installation
php composer.phar require d3yii2/d3files dev-master
- add to config/web.php
'modules' => [ 'd3files' => [ 'class' => 'd3yii2\d3files\D3Files', 'uploadDir' => dirname(__DIR__) . '\upload\d3files', 'disableController' => false, // set true to disable d3files controller to use model's controllers 'hashSalt' => false, // Set salt in your web-local.php config, empty value will disable sharing 'sharedExpireDays' => 5, 'sharedLeftLoadings' => 5, 'controllerRoute' => 'delivery/attachments', //define controler route, where defined ], ],
- migration configuration. Add to console migration definition path
'controllerMap' => [ 'migrate' => [ 'class' => 'yii\console\controllers\MigrateController', 'migrationPath' => [ '@d3yii2/d3files/migrations', ], ],
- do migration
yii migrate
Usage
Widget
Allow upload, download, delete files for model record.
<?= d3yii2\d3files\widgets\D3FilesWidget::widget( [ 'model' => $model, 'model_id' => $model->id, 'title' => 'Widget Title', 'icon' => false, 'hideTitle' => false, 'readOnly' => false, //'viewByFancyBox' => false, //'controllerRoute'=>'/d3emails/email/', //use if different controllers // 'actionColumn' => static function ($row) { // return 'OK'; //} ] ) ?>
D3FilesPreviewWidget
Extends D3FilesWidget with file preview.
<?= d3yii2\d3files\widgets\D3FilesPreviewWidget::widget( [ 'model' => $model, 'model_id' => $model->id, 'title' => 'Preview Widget Title', 'readOnly' => false, ] ) ?>
File types are determined automatically to load PDF or images inside modal dialog window.
Dependencies:
eaBlankonThema\widget\ThModal
d3system\yii2\web\D3SystemView
Main layout should have footer code:
<?php if ($footer = $this->getPageFooter()): ?> <?= $footer ?> <?php endif; ?> ======= ### Widget Allow upload, download, delete files for model record. ```php <?= d3yii2\d3files\widgets\D3FilesPreviewWidget::widget( [ 'model' => $model, 'model_id' => $model->id, 'title' => 'Widget Title', 'readOnly' => false, ] ) ?>
Access control
In config disableController set true for disabling use d3files controller, where no realised any access control.
'modules' => [ 'd3files' => [ .... 'disableController' => true, // set true to disable d3files controller to use model's controllers ..... ], ],
For implementing access control add separate actions for upload, download and delete to model controller. Can implement any standard Yii2 access control. For example RBAC.
/** * @inheritdoc */ public function behaviors() { $addBehaviors = [ 'access' => [ 'class' => \yii\filters\AccessControl::className(), 'only' => ['d3filesdownload', 'd3filesupload', 'd3filesdelete'], 'rules' => [ // deny all POST requests [ 'allow' => true, 'actions' => [ 'd3filesdownload', 'd3filesopen', 'd3filesupload', 'd3filesdelete', 'd3fileseditnotes' ], 'roles' => ['role1','role2'], ], ], ], 'verbs' => [ 'class' => \yii\filters\VerbFilter::className(), 'actions' => [ 'd3filedelete' => ['POST'], 'd3fileupload' => ['POST'], ], ], ]; return array_merge(parent::behaviors(), $addBehaviors); } public function actions() { return [ 'd3filesdownload' => [ 'class' => d3yii2\d3files\components\DownloadAction::class, 'modelName' => D3pPerson::class, ], 'd3filesupload' => [ 'class' => d3yii2\d3files\components\UploadAction::class, 'modelName' => D3pPerson::class, ], 'd3filesdelete' => [ 'class' => \d3yii2\d3files\components\DeleteAction::class, 'modelName' => D3pPerson::class, ], // for D3FilesPreviewWidget 'd3filesopen' => [ 'class' => Dd3yii2\d3files\components\ownloadAction::class, 'modelName' => D3pPerson::class, 'downloadType' => 'open' ], // for D3FilesPreviewWidget 'd3filesopen' => [ 'class' => 'd3yii2\d3files\components\DownloadAction', 'modelName' => RkInvoice::class, 'downloadType' => 'open' ], // for D3FilesPreviewWidget 'd3fileseditnotes' => [ 'class' => EditNotesAction::class, 'modelName' => D3pPerson::class, ], ]; }
Widget
d3yii2\d3files\widgets\D3FilesWidget::widget( [ 'model' => $model, 'model_id' => $model->id, 'title' => 'Attachments', 'icon' => false, 'hideTitle' => false, 'readOnly' => false ] )
Preview widget (load in modal dialog window)
d3yii2\d3files\widgets\D3FilesPreviewWidget::widget([ 'model' => $model, // Model to load attachment(s) from 'fileList' => [...] // Resulting array of the ModelD3Files::fileListForWidget if the attachments are joined already. Required if model not specified. 'defaultExtension' => 'pdf', // Optional (PDF by default), 'viewExtensions' => ['pdf'] // Optional.- (['pdf', 'png', 'jpg', 'jpeg'] by default) ])
For the PDF files server should support iframes. If the files are not loading check for the x-frame-options in the respose headers. In case:
x-frame-options: deny
You can set set in webserver configuration:
X-Frame-Options:SAMEORIGIN
Or one of the directives in .htaccess
X-Frame-Options: sameorigin
X-Frame-Options: "allow-from https://example.com/"
Active Form
- to Active form model add property for uploading file
public $uploadFile;
- to Active model for new attribute add rule
public function rules() { return [ ......, [ ['uploadFile'], 'file', 'skipOnEmpty' => true, 'extensions' => 'png, jpg, pdf, xls, doc' ], ]; }
- in controller add use
use d3yii2\d3files\models\D3files;
- in controller action after successful save() add
$model->uploadFile = UploadedFile::getInstance($model, 'uploadFile'); D3files::saveYii2UploadFile($model->uploadFile, ModelName::className(), $model->id);
- in form to Active form set 'enctype' = 'multipart/form-data',
$form = ActiveForm::begin([ 'id' => 'xxxxxxx', 'layout' => 'horizontal', 'enableClientValidation' => true, 'options' => [ 'enctype' => 'multipart/form-data', ], ] );
- in form view add upload field
echo $form->field($model, 'uploadFile')->fileInput();
Shared (public) access
- to create share implement share generation request in your code:
//$id is D3filesModel model's ID $share = D3filesModel::createSharedModel($id, $expireDays, $leftLoadings); $shared_id = $share['id']; $shared_hash = $share['hash'];
- and use those variables to create url:
$url = 'http://www.yoursite.com/index.php?r=d3files/d3files/downloadshare&id=' . $shared_id . '&hash=' . $shared_hash; echo $url;
Get record files list
use d3yii2\d3files\models\D3files; $filesList = D3files::getRecordFilesList($model::className(),$model->id)
Get record files with full path
public static function getRecordFiles(string $className, int $recordId): array { $files = []; foreach (D3Files::getModelFilesList($className, $recordId, true) as $file) { $fileHandler = new FileHandler([ 'model_name' => $file['className'], 'model_id' => $file['id'], 'file_name' => $file['file_name'] ]); $files[] = [ 'fileName' => $file['file_name'], 'filePath' => $fileHandler->getFilePath(), ]; } return $files; }
Attach existing file to record
$fileTypes = '/(gif|pdf|dat|jpe?g|png|doc|docx|xls|xlsx|htm|txt|log|mxl|xml|zip)$/i'; $model = Users::findOne($id); $fileName = 'MyAvatar.jpg'; $filePath = '/temp/avatar.jpg'; D3files::saveFile($fileName, Users::className(), $model->id, $filePath, $fileTypes);
Attach already saved file to record
$model = Users::findOne($id); D3filesModel::createCopy($fileModelId, Users::class, $model->id);
Maintenance commands
Soft deletes files (sets deleted=1) For model dektrium\user\models\User soft delete from database for model dektrium\user\models\User oldest as 12 months files with extension xml
yii d3files/clean-files/remove-older-than 'dektrium\user\models\User' 12 '%.xml'
Deletes files and corresponding records in database which have deleted=1
yii d3files/clean-files/remove-files 'dektrium\user\models\User'
Deletes model files from filesystem with out refence in database
yii d3files/clean-files/unused-files 'poker\poker\models\PkPlaygroundFixes'
Change log
- 0.9.0 (Feb 26, 2017) - added RU translation
- 0.9.3 (May 29, 2017) - auto creating upload directories
- 0.9.4 (Nov 16, 2017) - added parameter controllerRoute
- 0.9.13 (Jul 2, 2018) - added action column
- 0.9.93 (febr 10, 2022) - added controller d3files/clean-files for maintenance
- 0.9.97 (jun 28, 2022) - improved maintanance controller d3files/clean-files