Download the PHP package djurovicigoor/app-lifecycle without Composer
On this page you can find all versions of the php package djurovicigoor/app-lifecycle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download djurovicigoor/app-lifecycle
More information about djurovicigoor/app-lifecycle
Files in djurovicigoor/app-lifecycle
Package app-lifecycle
Short Description App lifecycle state detection plugin for NativePHP Mobile detects foreground/background transitions on Android and iOS.
License MIT
Informations about the package app-lifecycle
AppLifecycle Plugin for NativePHP Mobile
App lifecycle state detection for NativePHP Mobile — detects foreground/background transitions on Android and iOS.
Installation
Plugin Registration
Register the plugin in your NativeServiceProvider:
Usage
PHP — Laravel Event Listener
Register a listener in your AppServiceProvider:
Or use a dedicated listener class:
⚠️ NativePHP Mobile has no queue worker. Do not implement
ShouldQueueon your listeners — jobs will be written to the database but never processed. Keep listener logic fast and synchronous.
PHP — Livewire Component
Use the #[On] attribute with the native: prefix in any Livewire component:
JavaScript — Vue 3 (Composition API)
JavaScript — React
JavaScript — Vanilla / Inertia
Events
AppForegrounded
Fired when the user returns the app to the foreground after it was previously backgrounded.
Note: This event does not fire on initial app launch — only on genuine background → foreground transitions.
PHP class: Djurovicigoor\AppLifecycle\Events\AppForegrounded
| Property | Type | Description |
|---|---|---|
$timestamp |
int |
Unix timestamp in milliseconds when the transition occurred |
AppBackgrounded
Fired when the user leaves the app (presses Home, switches apps, or locks the screen).
PHP class: Djurovicigoor\AppLifecycle\Events\AppBackgrounded
| Property | Type | Description |
|---|---|---|
$timestamp |
int |
Unix timestamp in milliseconds when the transition occurred |
JavaScript API
| Function | Parameters | Returns | Description |
|---|---|---|---|
onAppForegrounded(handler) |
handler: ({ timestamp: number }) => void |
() => void |
Subscribe to foreground transitions |
onAppBackgrounded(handler) |
handler: ({ timestamp: number }) => void |
() => void |
Subscribe to background transitions |
Events.AppLifecycle.AppForegrounded |
— | string |
PHP class name constant |
Events.AppLifecycle.AppBackgrounded |
— | string |
PHP class name constant |
Platform Behavior
Android
- Foreground detection uses
NativePHPLifecycle.ON_RESUME - Background detection uses
NativePHPLifecycle.ON_PAUSE - The initial
onResumeat app launch is suppressed — awasBackgroundedguard ensures only genuine returns fire the event - NativePHP's activity declares
android:configChanges="uiMode|colorMode|orientation|screenSize", so screen rotation does not trigger false foreground/background events
iOS
- Foreground detection uses
UIApplication.willEnterForegroundNotification - Background detection uses
UIApplication.didEnterBackgroundNotification willEnterForegroundfires only when returning from the background, not on initial app launch — no extra guard is needed
Plugin Details
| Field | Value |
|---|---|
| Author | Djurovic Igor |
| Version | 1.0.0 |
| License | MIT |
| Android min SDK | 21 |
| iOS min version | 15.0 |
| Platforms | Android, iOS |
| NativePHP Mobile | ^3.0 |
| PHP | ^8.2 |
Support
For questions or issues, email [email protected]
License
The MIT License (MIT). Please see License File for more information.