Plugin Marketplace

nativephp/mobile-file

File operations plugin for NativePHP Mobile

#File Plugin for NativePHP Mobile

File operations (move, copy) for NativePHP Mobile applications.

#Overview

The File API provides cross-platform file manipulation operations.

#Installation

Copied!
composer require nativephp/mobile-file

#Usage

#PHP (Livewire/Blade)

Copied!
use Native\Mobile\Facades\File;
 
// Move a file
$result = File::move('/path/to/source.txt', '/path/to/destination.txt');
 
if ($result['success']) {
    echo 'File moved successfully!';
}
 
// Copy a file
$result = File::copy('/path/to/source.txt', '/path/to/copy.txt');
 
if ($result['success']) {
    echo 'File copied successfully!';
}

#JavaScript (Vue/React/Inertia)

Copied!
import { file } from '#nativephp';
 
// Move a file
const result = await file.move('/path/to/source.txt', '/path/to/destination.txt');
 
if (result.success) {
    console.log('File moved successfully!');
}
 
// Copy a file
const result = await file.copy('/path/to/source.txt', '/path/to/copy.txt');
 
if (result.success) {
    console.log('File copied successfully!');
}

#Methods

#move(string $from, string $to): array

Moves a file from source to destination.

Parameter Type Description
from string Source file path
to string Destination file path

Returns:

  • success: bool - Whether the operation succeeded
  • error: string - Error message if operation failed (optional)

#copy(string $from, string $to): array

Copies a file from source to destination.

Parameter Type Description
from string Source file path
to string Destination file path

Returns:

  • success: bool - Whether the operation succeeded
  • error: string - Error message if operation failed (optional)

#Behavior

  • Parent directories are created automatically if they don't exist
  • Existing destination files are overwritten
  • File integrity is verified after copy operations
  • On Android, if rename fails (cross-filesystem), falls back to copy + delete

#Examples

#Move File to Permanent Storage

Copied!
use Native\Mobile\Facades\File;
 
$tempPath = '/var/mobile/Containers/Data/tmp/recording.m4a';
$permanentPath = storage_path('recordings/recording.m4a');
 
$result = File::move($tempPath, $permanentPath);
 
if ($result['success']) {
    // File moved successfully
}

#Backup File Before Edit

Copied!
use Native\Mobile\Facades\File;
 
public function editFile($filePath)
{
    // Create backup
    $backupPath = str_replace('.txt', '_backup.txt', $filePath);
    File::copy($filePath, $backupPath);
 
    // Proceed with editing...
}