Download the PHP package entoknakal/file-picker without Composer
On this page you can find all versions of the php package entoknakal/file-picker. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download entoknakal/file-picker
More information about entoknakal/file-picker
Files in entoknakal/file-picker
Package file-picker
Short Description Native document/file picker plugin for NativePHP Mobile v4
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package file-picker
FilePicker Plugin for NativePHP Mobile
A FilePicker plugin designed for NativePHP Mobile (Android only).
Features
- Single & Multiple Selection Support: Easily toggle between picking a single file or multiple files simultaneously using the multiple parameter.
- Flexible File Filtering: Filter choices using broad aliases (e.g., photos, videos), explicit MIME types (e.g., application/pdf), or specific file extensions.
- Asynchronous Copying & Stream Handling: Moves assets safely from temporary Android cache locations into custom Laravel Storage disks using the FilePickerCopy event.
- Robust Error Handling: Captured Kotlin constraints, access denials, or criteria mismatches are cleanly returned as customizable error exceptions.
Dependencies
Before installing, ensure your project meets the following requirements:
- PHP 8.3 or higher
- Laravel 12.x / 13.x
- NativePHP Mobile framework (Android environment configured)
- Minimum Android version: 12
Installation
Follow these steps to install and register the plugin in your project:
-
Install the package via Composer:
-
Ensure you have published the NativeServiceProvider:
-
Register the plugin:
- Verify that NativePHP recognizes the plugin:
Usage
To implement the FilePicker in your NativePHP Mobile application, follow these steps to create a NativeComponent and its corresponding Blade view.
1. Create the NativeComponent Class
Create or update your component file named PickFile.php inside the app/NativeComponents directory:
2. Create the Blade View Template
Create or update your template file named pick-file.blade.php inside the resources/views/native directory:
Multiple File Selection Configuration
By default, the plugin opens the system file explorer in single-file mode. To enable multiple file selection, configure the $multiple state in your component:
- Single Selection (Default): public bool $multiple = false; (Allows picking only one file).
- Multiple Selection: Set public bool $multiple = true; inside your PickFile component before executing FilePicker::open().
3. File Processing & Asynchronous Copy via FilePickerCopy
When a file is successfully selected on Android, the plugin returns an absolute path referencing the Android sandbox cache directory. To automate transferring this temporary asset safely into your app's standard storage disks, dispatch the FilePickerCopy event.
Dispatching with Custom Parameters
By default, triggering FilePickerCopy::dispatch($path, $name) moves your asset into a folder named ztssUpload within the mobile_public disk. You can customize the destination variables when constructing the event:
Event Variable Overview
The FilePickerCopy constructor accepts the following properties:
| Variable | Type | Default Value | Description |
|---|---|---|---|
sourcePath |
string |
Required | The absolute source path pointing to the temporary Android cache location. |
originalName |
string |
Required | The original file name used to output and name the target file structure. |
targetFolder |
string |
'ztssUpload' |
Subfolder pathway path inside the designated disk system where the file should land. |
disk |
string |
'mobile_public' |
The core file system storage disk target identifier registered under your Laravel environment. |
How It Works Under the Hood
Once dispatched, the built-in listener executes these underlying routines:
- Verifies the existence of the source asset inside the local cache workspace.
- Dynamically creates the nested
targetFoldertree structure if it does not exist yet on the selected disk framework. - Safely streams file contents using native drivers into your project storage profile.
- Automatically housekeeps and calls
@unlink()on the temporary Android cache source upon a successful file transfer event completion.
Supported File Types
The plugin parses filter inputs flexibly. You can pass broad group aliases, explicit MIME types, or specific extensions to the $allowedTypes array configuration:
-
Group Aliases: If you provide a keyword alias like
photos, the file picker will automatically restrict choices and validate files matching theimage/*MIME type scope. - Explicit MIME Types: You can also specify exact strict MIME type identifiers directly within the array parameters.
Predefined Keyword Mapping Reference
The following table outlines how built-in string values are normalized and translated into standard Android targets:
| Keyword Alias / Group | Resolved Android MIME Type Target(s) |
|---|---|
*, */*, all |
*/* (Allows selection of any file type) |
images, image, photo, photos, picture, pictures |
image/* |
videos, video, movie, movies |
video/* |
audios, audio, sound, sounds, music |
audio/* |
pdf |
application/pdf |
zip |
application/zip, application/x-zip-compressed |
rar |
application/vnd.rar, application/x-rar-compressed |
word, doc, docx |
application/msword, application/vnd.openxmlformats-officedocument.wordprocessingml.document |
excel, xls, xlsx |
application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
ppt, pptx, powerpoint |
application/vnd.ms-powerpoint, application/vnd.openxmlformats-officedocument.presentationml.presentation |
txt, text |
text/plain |
csv |
text/csv |
Note: If a custom standalone extension or unrecognized MIME string is processed and cannot be resolved by the device's standard MimeTypeMap registry, the Kotlin backend gracefully defaults to application/octet-stream or application/$ext to prevent execution crashes.
Buy me a coffee :)
If this plugin helped you save time or brought value to your projects, consider supporting my work! Your donations will go directly toward upgrading my hardware setup so I can keep developing innovative tools.
Buy me a coffeeOr:
Trakteer Saya :)
License
The MIT License (MIT). Please see the License File for more information.
