Weave Code
Netgsm Laravel Package
tarfin-labs/netgsm
Laravel package for sending SMS through NetGSM, a Turkish SMS gateway. It offers a simple, fluent API for sending single or bulk messages, checking delivery reports, and managing account details, with configuration handled through Laravel's config and service container.
netgsm sms package for laravel 8.x, 9.x and 10.x
Frequently asked questions about Netgsm
- How do I install tarfin-labs/netgsm in a Laravel application?
- Install the package with Composer using composer require tarfin-labs/netgsm. Laravel's package auto-discovery registers the service provider and facade, so no manual registration is normally needed. After that, publish the configuration file with the vendor:publish command and fill in your NetGSM credentials. No additional infrastructure or background services are required.
- Which Laravel and PHP versions does this NetGSM SMS package support?
- The package is described as supporting Laravel 8.x, 9.x and 10.x. Exact PHP constraints live in the package's composer.json, so check that file before committing. Because minor releases can change constraints or return types, confirm the specific version you plan to install against your application's Laravel and PHP matrix. That constraint check is the gating step, not the release notes.
- How do I configure NetGSM credentials such as user code, password and message header?
- Configuration is handled through Laravel's config system after you publish the package config file. You provide your NetGSM user code, password and the approved message header (sender name) there. Keep these values in your .env file rather than committing them to source control. The service container then resolves a configured client for the facade or notification channel.
- How do I send a single SMS or bulk messages with this package?
- The package exposes a simple, fluent API through its facade for sending one message or many recipients in a single call. You pass the message body and the phone numbers, and the package handles the request to the NetGSM gateway. Typical usage is a short chained call inside a service class or job. For bulk sends, keep an eye on the gateway's per-request limits and batch accordingly.
- Does the package provide a Laravel notification channel for SMS?
- The package follows the conventional Laravel package shape and includes a notification channel alongside the facade. That lets you route notifications to SMS by defining a toNetgsm method on your notification class. If your version does not ship the channel, you can still call the facade directly from a queued job. Check the package source for your installed version to confirm the channel is present.
- How do I check SMS delivery reports with tarfin-labs/netgsm?
- Sending a message returns a job ID that you use to query the gateway for delivery status. The package wraps the NetGSM endpoints for checking reports and account details behind the same fluent API. Store the returned job ID if you need to reconcile delivery later. Note that the job ID is a string, not an integer, since version 5.3.0.
- Why did jobId change from int to string in version 5.3.0, and will it break my code?
- Version 5.3.0 stopped casting the gateway-assigned job ID to an integer and returns it as a string, which avoids overflow or truncation on large identifiers. The change shipped as a minor release, so a normal ^5.x constraint will pull it in automatically. Any code that type-hints int, casts with (int), compares with === against an integer, or stores the value in a BIGINT column will break or silently misbehave. Audit your jobId usage and migrate storage to a string column before upgrading.
- Is this package a provider-agnostic SMS abstraction or a single-vendor adapter?
- It is a thin adapter for NetGSM, a Turkish SMS gateway, not a provider-agnostic abstraction. It fits well if you are already on NetGSM or plan to be, and it adds little ceremony to a Laravel app. If you need to swap gateways later, wrap the facade behind your own small interface so the vendor dependency stays in one place. There is no built-in support for other providers.
- How can I test SMS sending without hitting the real NetGSM gateway?
- The package has a small surface area, so mocking the facade or faking the underlying HTTP client in your test suite is usually enough. Assert that the expected recipient and message body reach the client, and assert the returned job ID is a string. If a NetGSM sandbox or test account is available, run a small integration test against it before rollout. Add a regression test for jobId typing so a future minor release cannot silently change it again.
- Is tarfin-labs/netgsm safe to use in production and how is it maintained?
- The codebase is small and releases are infrequent, so ongoing maintenance cost is low. The real risk is governance: it is a single-vendor, regionally focused package with no commercial SLA, and maintainers have shipped a return-type change in a minor version. Pin to an exact version or a tight range and review each release rather than trusting ^5.0. Also confirm who owns your NetGSM account relationship and what happens if the gateway or package goes stale.
Weaver
How can I help you explore Laravel packages today?