Share Plugin for NativePHP Mobile#
Native share sheet for sharing URLs and files in NativePHP Mobile applications.
Overview#
The Share API provides cross-platform native share sheet functionality for sharing URLs, text, and files.
Installation#
Copied!
composer require nativephp/mobile-shareUsage#
Share a URL#
PHP (Livewire/Blade)
Copied!
use Native\Mobile\Facades\Share; // Share a URL with title and textShare::url('Check this out!', 'Found this great article', 'https://example.com');JavaScript (Vue/React/Inertia)
Copied!
import { Share } from '#nativephp'; // Share a URLawait Share.url('Check this out!', 'Found this great article', 'https://example.com');Share a File#
PHP
Copied!
use Native\Mobile\Facades\Share; // Share a fileShare::file('My Recording', 'Listen to this!', '/path/to/audio.m4a'); // Share just text (no file)Share::file('Hello', 'This is my message', '');JavaScript
Copied!
import { Share } from '#nativephp'; // Share a fileawait Share.file('My Recording', 'Listen to this!', '/path/to/audio.m4a'); // Share just textawait Share.file('Hello', 'This is my message');Methods#
url(string $title, string $text, string $url)#
Opens the native share sheet with a URL.
| Parameter | Type | Description |
|---|---|---|
title |
string | Share dialog title / subject |
text |
string | Text message to include with the URL |
url |
string | The URL to share |
file(string $title, string $text, string $filePath)#
Opens the native share sheet with a file or text.
| Parameter | Type | Description |
|---|---|---|
title |
string | Share dialog title / subject |
text |
string | Text message to share |
filePath |
string | Absolute path to file (optional) |
Supported File Types#
The share sheet automatically detects MIME types for common file formats:
Audio: m4a, aac, mp3, wav, ogg, flac Video: mp4, m4v, mov, avi, mkv, webm Images: jpg, jpeg, png, gif, webp Documents: pdf, txt
Platform Behavior#
Android#
- Uses
Intent.ACTION_SENDwithIntent.createChooser - Files are shared via
FileProviderfor security - Temporary copies are made for files in app storage
- Old share temp files are automatically cleaned up
iOS#
- Uses
UIActivityViewController - Supports iPad popover presentation
- Files are shared directly via file URLs