Weave Code
Beem Php Laravel Package
beemlabs/beem-php
beemlabs/beem-php is a PHP client for the Beem Africa API, making it easy to send SMS, manage contacts, and integrate messaging features into your Laravel or PHP applications through a simple, expressive wrapper.
The official PHP SDK for Beem
Frequently asked questions about Beem Php
- Is beemlabs/beem-php a Laravel package or a framework-agnostic PHP SDK?
- beemlabs/beem-php is a framework-agnostic PHP SDK for the Beem Africa API. As of v0.1.0 it does not ship a Laravel ServiceProvider, facade, publishable config, or auto-discovery, so Laravel integration is something you wire up yourself in the container. The core client can still be used in Laravel, but the ergonomic Laravel bridge is not included.
- How do I install beemlabs/beem-php in a Laravel application?
- Install it with Composer using composer require beemlabs/beem-php. Because it is not a Laravel package, you will need to bind the client as a singleton in a service provider and supply your Beem credentials from environment variables. Check the PHP version constraint against your runtime before committing.
- Does beemlabs/beem-php support Laravel auto-discovery and config publishing?
- No. The v0.1.0 release is deliberately framework-agnostic and does not include Laravel auto-discovery, a publishable config file, or a facade. You must manually register the client and manage configuration yourself. A first-party Laravel bridge may come later, but it is not part of the current release.
- What Laravel and PHP versions does beemlabs/beem-php support?
- The package does not publish a documented PHP and Laravel version support matrix in the provided notes. You should verify the Composer PHP constraint against your runtime, for example PHP 8.1, 8.2, or 8.3, before adopting it. Because it is framework-agnostic, Laravel version compatibility depends on your integration code rather than the package itself.
- How do I send an SMS with beemlabs/beem-php in Laravel?
- Instantiate the Beem client with your API credentials and call the SMS-sending method provided by the SDK. In Laravel, bind the client in a service provider so you can inject it into controllers, jobs, or notification channels. Keep credentials in .env and never commit them to source control.
- How should I store Beem API credentials securely in a Laravel app?
- Put your Beem API key and secret in environment variables and read them through Laravel's config system, ideally with a dedicated config file that is not committed with secrets. Avoid hardcoding credentials in the SDK instantiation or in versioned configuration. Use your platform's secret manager for production deployments.
- Is beemlabs/beem-php stable enough for production at v0.1.0?
- v0.1.0 is pre-1.0 and comes with no stability guarantee, so minor bumps may include breaking changes. Pin the package to an exact version or a commit hash and treat upgrades as reviewed changes. For production, plan a short spike to validate behavior before rolling it out broadly.
- Does beemlabs/beem-php work with Laravel queues, Horizon, or Octane?
- The SDK has no built-in job, queue, Octane, or Horizon awareness, and it does not provide request-scoped user context out of the box. You can still use it inside queued jobs or Octane workers, but you are responsible for managing client lifecycle and any correlation data. Verify behavior in each execution context you use.
- How do I test beemlabs/beem-php without hitting the Beem API?
- Wrap the SDK client behind an interface or container binding and substitute a fake or mock in your test suite. That lets you assert that SMS-sending calls are made without making real HTTP requests. You can also use Laravel's HTTP client faking if your integration routes through it.
- What are alternatives to beemlabs/beem-php for sending SMS in Laravel?
- You can call the Beem Africa REST API directly with Laravel's HTTP client, use a community Laravel notification channel for SMS, or choose another SMS provider with a first-party Laravel package. beemlabs/beem-php is the official SDK, so it may be preferable if you want vendor-supported access to Beem-specific features like contact management. Evaluate maintenance and support guarantees before committing.
Weaver
How can I help you explore Laravel packages today?