PHPackages yii2-extensions/filepond - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [File & Storage](/categories/file-storage) 4. / 5. yii2-extensions/filepond ActiveLibrary[File & Storage](/categories/file-storage) yii2-extensions/filepond ======================== FilePond Widget for Yii Framework. 2559↓33.3%2[1 issues](https://github.com/yii2-extensions/filepond/issues)PHPCI passing Since Dec 14Pushed 1y ago1 watchersCompare [ Source](https://github.com/yii2-extensions/filepond)[ Packagist](https://packagist.org/packages/yii2-extensions/filepond)[ RSS](/packages/yii2-extensions-filepond/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) [ ![](https://camo.githubusercontent.com/cc75562bca6e54e98046e4fb187ef8d96c997a8f31c6f4d2f6ed0c816413b47a/68747470733a2f2f7777772e7969696672616d65776f726b2e636f6d2f696d6167652f7969695f6c6f676f5f6c696768742e737667) ](https://github.com/yii2-extensions/filepond) FilePond. ========= [](#filepond) [ ![php-version](https://camo.githubusercontent.com/cfe9179013aaeb962182231f5cc56946d96d3c7356e64008b58bad1025cfb1e9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253345253344382e312d373837434235) ](https://www.php.net/releases/8.1/en.php) [ ![PHPUnit](https://github.com/yii2-extensions/filepond/actions/workflows/build.yml/badge.svg) ](https://github.com/yii2-extensions/filepond/actions/workflows/build.yml) [ ![PHPUnit](https://github.com/yii2-extensions/filepond/actions/workflows/compatibility.yml/badge.svg) ](https://github.com/yii2-extensions/filepond/actions/workflows/compatibility.yml) [ ![Codecov](https://camo.githubusercontent.com/c00b790149b8ca3e22ecbad5ba8de67480130c7154be58c8a6a4572dc2f7666a/68747470733a2f2f636f6465636f762e696f2f67682f796969322d657874656e73696f6e732f66696c65706f6e642f6272616e63682f6d61696e2f67726170682f62616467652e7376673f746f6b656e3d4d4630585547564c5943) ](https://codecov.io/gh/yii2-extensions/filepond) [ ![Infection](https://camo.githubusercontent.com/80e70c6144205ba7ded9937e852c63794aa7a8c85b20b4cf4c1834d2fc73dbd1/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e743f7374796c653d666c61742675726c3d687474707325334125324625324662616467652d6170692e737472796b65722d6d757461746f722e696f2532466769746875622e636f6d253246796969322d657874656e73696f6e7325324666696c65706f6e642532466d61696e) ](https://dashboard.stryker-mutator.io/reports/github.com/yii2-extensions/filepond/main) [![filepond](docs/images/filepond.png)](docs/images/filepond.png) Installation ------------ [](#installation) The preferred way to install this extension is through [composer](https://getcomposer.org/download/). Either run ``` composer require --dev --prefer-dist yii2-extensions/filepond ``` or add ``` "yii2-extensions/filepond": "dev-main" ``` to the require-dev section of your `composer.json` file. Usage ----- [](#usage) ### Name [](#name) ``` use Yii2\Extensions\Filepond\FilePond; echo FilePond::widget(['name' => 'image_file']); ``` ### Active Field [](#active-field) ``` use Yii2\Extensions\Filepond\FilePond; echo $form ->field($formModel, 'image_file') ->widget( FilePond::class, [ 'loadFileDefault' => $imageFile, 'imagePreviewHeight' => 170, 'imageCropAspectRatio' => '1:1', ], ); ``` ### Controller or Model [](#controller-or-model) ``` use Yii2\Extensions\Filepond\FileProcessing; $imageFile = FileProcessing::saveWithReturningFile( $categoryForm->image_file, Yii::getAlias('@uploads'), "category{$category->id}", false ); ``` ### Properties of the widget [](#properties-of-the-widget) PropertyTypeDescriptionDefault`acceptedFileTypes``string`The accepted file types. Can be mime types or wild cards.`[]``allowFileTypeValidation``bool`Whether to allow file type validation.`true``allowFileRename``bool`Whether to allow file rename.`false``allowFileValidateSize``bool`Whether to allow file size validation.`true``allowImageCrop``bool`Whether to allow image crop.`false``allowImageExifOrientation``bool`Whether to allow image exif orientation.`true``allowImagePreview``bool`Whether to allow image preview.`true``allowImageTransform``bool`Whether to allow image transform.`false``allowMultiple``bool`Whether to allow multiple files.`false``allowpdfPreview``bool`Whether to allow pdf preview.`false``cssClass``string`The css class of the widget.`''``cdn``boolean`Whether to use the CDN.`true``config``array`The config of the widget.`[]``fileRename``string`The file rename.`''`use: `fileRenameFunction: (file) => return `my\_new\_name${file.extension}`;`fileValidateTypeDetectType``string`The file validate type detect type function.`''``fileValidateTypeLabelExpectedTypes``string`The file validate type label expected types.`''``imageCropAspectRatio``string,null`The image crop aspect ratio.`null``imagePreviewHeight``string,null`The image preview height.`null``imagePreviewMarkupShow``bool`Whether to show the image preview markup.`true``imagePreviewMaxFileSize``string,null`The image preview max file size.`null``imagePreviewMaxHeight``int`The image preview max height.`256``imagePreviewMaxInstantPreviewFileSize``int`The image preview max instant preview file size.`10000000``imagePreviewMinHeight``int`The image preview min height.`44``imagePreviewTransparencyIndicator``string,null`The image preview transparency indicator.`null``imageTransformAfterCreateBlob``array,null`The image transform after create blob.`null``imageTransformBeforeCreateBlob``array,null`The image transform before create blob.`null``imageTransformOutputQuality``int,null`The image transform output quality.`null``imageTransformClientTransforms``array,null`The image transform client transforms.`null``imageTransformOutputQualityMode``string,null`The image transform output quality mode.`añways``imageTransformOutputStripImageHead``bool`The image transform output strip image head.`true``imageTransformVariants``array,null`The image transform variants.`null``imageTransformVariantsIncludeDefault``bool`The image transform variants include default.`true``imageTransformVariantsDefaultName``string,null`The image transform variants default name.`null``imageTransformVariantsIncludeOriginal``bool`The image transform variants include original.`false``labelIdle``string`The label idle.`''``labelMaxFileSize``string`The label max file size.`''``labelMaxFileSizeExceeded``string`The label max file size exceeded.`''``labelMaxTotalFileSize``string`The label max total file size.`''``labelMaxTotalFileSizeExceeded``string`The label max total file size exceeded.`''``labelFileTypeNotAllowed``string`The label file type not allowed.`''``loadFileDefault``string`The load file default.`''``maxFiles``int`The max files.`1``maxFileSize``string,null`The max file size.`null``maxTotalFileSize``string,null`The max total file size.`null``minFileSize``string,null`The min file size.`null``pluginDefault``array`The plugins default.`[``FilePondPluginFileValidateType,``FilePondPluginFileValidateSize,``FilePondPluginFileValidateType,``FilePondPluginImageExifOrientation,``FilePondPluginImagePreview,``]``pdfPreviewHeight``int`The pdf preview height.`320``pdfComponentExtraParams``string`The pdf component extra params.`toolbar=0&view=fit&page=1``required``bool`Whether the field is required.`false`### Translation support [](#translation-support) The extension supports translation. You can translate the extension into your language, for default the extension supports the following languages: - Chinese - English - French - German - Poland - Portuguese - Russian - Spanish Quality code ------------ [](#quality-code) [![static-analysis](https://github.com/yii2-extensions/filepond/actions/workflows/static.yml/badge.svg)](https://github.com/yii2-extensions/filepond/actions/workflows/static.yml)[![phpstan-level](https://camo.githubusercontent.com/17a9258ed6588a68408bb21370872041ef994ea597548332232523398ab33dc6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2532306c6576656c2d352d626c7565)](https://github.com/yii2-extensions/filepond/actions/workflows/static.yml)[![StyleCI](https://camo.githubusercontent.com/e2776bdbbd3c2b24b3b9e1a2a4ee90c1dddb4bf57fc6049538b2cf3d656df745/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3731393037303633302f736869656c643f6272616e63683d6d61696e)](https://github.styleci.io/repos/719070630?branch=main) Support versions Yii2 --------------------- [](#support-versions-yii2) [![Yii20](https://camo.githubusercontent.com/eb75eedd3cbc9159c862871d7ba5a079f2d8843e186c4365f72e55b402076f4b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5969693225323076657273696f6e2d322e302d626c7565)](https://github.com/yiisoft/yii2/tree/2.0.49.3)[![Yii22](https://camo.githubusercontent.com/f946cb5d9010fb3cc3f9d9530b51fee224bdbabe1345dd3f090dfbca82446217/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5969693225323076657273696f6e2d322e322d626c7565)](https://github.com/yiisoft/yii2/tree/2.2) Testing ------- [](#testing) [Check the documentation testing](/docs/testing.md) to learn about testing. Our social networks ------------------- [](#our-social-networks) [![Twitter](https://camo.githubusercontent.com/d077c362ac639792171af8bc002ee827816733dfc0925f70b557e6d151022226/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f747769747465722d666f6c6c6f772d3144413146323f6c6f676f3d74776974746572266c6f676f436f6c6f723d314441314632266c6162656c436f6c6f723d3535353535353f7374796c653d666c6174)](https://twitter.com/Terabytesoftw) License ------- [](#license) The MIT License. Please see [License File](LICENSE.md) for more information. ### Health Score 19 — LowBetter than 10% of packages Maintenance21 Infrequent updates — may be unmaintained Popularity22 Limited adoption so far Community13 Small or concentrated contributor base Maturity16 Early-stage or recently created project Bus Factor1 Top contributor holds 89.7% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/524d2b46690f41fce7188d369488a35e7624e6c5a264d82aacd08548bfd156ab?d=identicon)[terabytesoftw](/maintainers/terabytesoftw) --- Top Contributors [![terabytesoftw](https://avatars.githubusercontent.com/u/42547589?v=4)](https://github.com/terabytesoftw "terabytesoftw (26 commits)")[![ArtMin96](https://avatars.githubusercontent.com/u/29732308?v=4)](https://github.com/ArtMin96 "ArtMin96 (1 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (1 commits)")[![tomaszkane](https://avatars.githubusercontent.com/u/1530354?v=4)](https://github.com/tomaszkane "tomaszkane (1 commits)") --- Tags filepondwidgetyii2yii2-extensions ### Embed Badge ![Health badge](/badges/yii2-extensions-filepond/health.svg) ``` [![Health](https://phpackages.com/badges/yii2-extensions-filepond/health.svg)](https://phpackages.com/packages/yii2-extensions-filepond) ``` ### Alternatives [knplabs/gaufrette PHP library that provides a filesystem abstraction layer 2.5k39.8M123](/packages/knplabs-gaufrette)[google/cloud-storage Cloud Storage Client for PHP 34390.8M125](/packages/google-cloud-storage)[illuminate/filesystem The Illuminate Filesystem package. 15261.6M2.6k](/packages/illuminate-filesystem)[superbalist/flysystem-google-storage Flysystem adapter for Google Cloud Storage 26320.6M30](/packages/superbalist-flysystem-google-storage)[creocoder/yii2-flysystem The flysystem extension for the Yii framework 2931.7M62](/packages/creocoder-yii2-flysystem)[flowjs/flow-php-server PHP library for handling chunk uploads. Works with flow.js html5 file uploads. 2451.6M15](/packages/flowjs-flow-php-server) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)