Download the PHP package notideus/laravel-notideus without Composer

On this page you can find all versions of the php package notideus/laravel-notideus. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of notideus/laravel-notideus

Informations about the package laravel-notideus

laravel-notideus

Official Laravel integration for the Notideus email API. MIT licensed.

Bridges the notideus/notideus-php SDK into Laravel: a configurable NotideusClient singleton, a Notideus facade, a notideus mail transport (so any Mail::send() or Mailable rides the API), and a Notifications channel.

Requires PHP 8.2+ and Laravel 10/11/12. The service provider and facade alias are auto-discovered — nothing to register in config/app.php.

Install

Configuration

Publish the config:

Env var Config key Default Notes
NOTIDEUS_API_KEY api_key — your nt_live_… key
NOTIDEUS_BASE_URL base_url https://api.notideus.io override for self-hosting
NOTIDEUS_TIMEOUT timeout 30.0 request timeout (seconds)
NOTIDEUS_MAX_RETRIES max_retries 2 retries for network errors, 5xx and 429
NOTIDEUS_FROM_ADDRESS from_address — reserved — not consumed yet (see below)
NOTIDEUS_FROM_NAME from_name — reserved — not consumed yet (see below)

The client is registered as a singleton — app('notideus'), also aliased to Notideus\NotideusClient — built from this config.

NOTIDEUS_FROM_ADDRESS and NOTIDEUS_FROM_NAME are reserved for a future release: nothing reads them today (the provider only consumes api_key, base_url, timeout and max_retries). For an app-level default sender, use Laravel's mail.from config or pass from explicitly per send.

Usage

All SDK resources are reachable through the Notideus facade:

contacts(), whatsapp(), unsubscribe() and plans() work the same way. Params and responses use snake_case exactly like the API — see the API reference and the notideus/notideus-php README for the full resource surface.

Mail

Point the default mailer at the notideus transport:

Every Mail::send(), Mailable, and mail-channeled notification now goes through the API. The transport maps the message's from, to, subject and HTML (plus the text alternative and reply-to when set) onto POST /v1/emails, and derives an idempotency_key from the content so a retried send never double-sends.

Notifications

Route a notification through the NotideusChannel and define toNotideus(). Return the channel's class name from via() — the provider registers no named notideus notification driver:

The recipient comes from routeNotificationFor('notideus'), then routeNotificationFor('mail'), then the notifiable's $email property, and is sent as to unless toNotideus() sets it itself. The returned array takes the same snake_case params as emails()->send().

Error handling

Request-level failures throw Notideus\NotideusException:

Development

Pre-Packagist note. composer.json currently pins the core SDK through a temporary vcs repository (notideus/notideus-php: dev-main as 1.0.0 pointing at the GitHub repo), so composer install resolves it straight from source. For fully offline work, swap the vcs entry for a path repository pointing at a sibling sdk-php checkout. After notideus/notideus-php is submitted to Packagist, clean this up: drop the repositories entry and require ^1.0.

Releasing

  1. Update version in composer.json and merge to main.
  2. Create a GitHub Release with tag v<version> — it must match composer.json, the publish workflow verifies this and fails otherwise.
  3. The publish workflow runs the full gate (composer validate, install, lint, stan, test). There is no publish step and no secrets at all: Packagist auto-updates the package from the release tag.
  4. One-time setup: submit the repository on packagist.org (GitHub hook or manual "Update" enables auto-sync from tags). Unlike npm, Packagist has no registry-existence prerequisite — the very first release can go straight through the workflow.

All versions of laravel-notideus with dependencies

PHP Build Version
Package Version
Requires php Version >=8.2
illuminate/support Version ^10.0|^11.0|^12.0
notideus/notideus-php Version ^1.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package notideus/laravel-notideus contains the following files

Loading the files please wait ...