- Can I use this package with Laravel 8 or 9?
- No, this package is incompatible with Laravel 8/9 due to PHP 5.4 dependencies and lack of Laravel-specific features. It won’t integrate with Laravel’s service container, notifications system, or modern PHP versions (7.4+). You’d need a custom wrapper, which isn’t officially supported.
- What PHP versions does this package support?
- The package explicitly supports **only PHP 5.4**, which is end-of-life since 2015. Modern Laravel apps require PHP 8.0+ for security and performance. Running this on newer PHP versions risks runtime errors and security vulnerabilities.
- Does this package support Firebase or WebPush?
- No, this library is **OneSignal-only** and lacks support for Firebase Cloud Messaging (FCM), WebPush, or other push providers. If you need multi-channel notifications, consider alternatives like `laravel-notification-channels/onesignal` or Firebase’s official SDK.
- How do I integrate this with Laravel’s Notification system?
- There’s no native Laravel integration. You’d need to manually create a custom `NotificationChannel` class to bridge the legacy `OneSignalClient` with Laravel’s `Notification` contracts. This requires significant custom code and isn’t officially documented.
- Are there security risks using this package?
- Yes. PHP 5.4 is unsupported, exposing risks like unpatched OpenSSL, cURL, or HTTP library flaws. The package also lacks Laravel’s config abstraction, which could lead to hardcoded credentials or insecure API calls. Avoid in production without a migration plan.
- Does this package support OneSignal API v2?
- No, it uses **OneSignal API v1**, which is deprecated. API v2 requires authentication tokens and updated endpoints. Migrating would require rewriting core HTTP calls, and the package’s monolithic design makes this difficult.
- Can I queue notifications with this package?
- No, the package doesn’t support Laravel’s `ShouldQueue` trait or background job systems. Notifications are sent synchronously, which could block your application if API calls fail or time out.
- What alternatives should I consider for Laravel?
- For modern Laravel apps, use `laravel-notification-channels/onesignal` (actively maintained) or Firebase’s official PHP SDK. These support Laravel 8/9, queueable notifications, and multi-channel push. Avoid this package unless maintaining legacy PHP 5.4 systems.
- How do I handle rate limiting or retries?
- The package lacks built-in rate limiting or retry logic. You’d need to implement exponential backoff manually or wrap the `OneSignalClient` in a custom service that handles failures. This adds complexity and isn’t documented.
- Is this package actively maintained?
- No, the package was last updated in **2015** and is archived. It has no test suite, CI/CD, or Laravel-specific updates. Using it risks broken dependencies, API deprecations, and unsupported Laravel features. Prioritize modern alternatives.