Laravel SDK

composer require langsys/langsys-php-laravel Copy

PHP 8.1+ Laravel 10 / 11 / 12

Packagist ↗ GitHub ↗ Also: PHP SDK

Integrate the Langsys Translation Manager into a Laravel application — Blade, Livewire, Alpine’s server-rendered content, and Inertia SSR seeding for the JS SDKs.

This is the reference for langsys/langsys-php-laravel. For a walkthrough with a demo app, see the Laravel Learning Center page.

Requirements

• PHP 8.1+, Laravel 10, 11, or 12
• ext-intl (required — ICU plural rules and locale-aware number/date formatting). Note that the official php:8.x-fpm Docker images do not bundle it; add docker-php-ext-install intl.

Laravel 10 and 11

Both lines are past Laravel’s security-support window and carry unpatched advisories, so Composer 2.9+ refuses to lock any release in them by default. This package supports and tests both — CI runs the full suite against Laravel 10, 11 and 12 on every push — and adding it to an existing 10.x/11.x app works normally, because Composer blocks locking an advisory-flagged version, not having one. What it blocks is resolving the framework afresh: a new Laravel 10/11 project, or composer update laravel/framework within those lines. That’s Laravel’s advisory status rather than anything about this package, and if you hit it, composer config audit.block-insecure false is the (deliberate, project-wide) opt-out.

How it’s layered

langsys/langsys-php-laravel is a Laravel wrapper over the dependency-free langsys/langsys-php — which owns the HTTP client, phrase lookup, placeholder interpolation, token discovery/queueing, and catalog caching. This package adds only the Laravel-native concerns:

• A service provider that builds the SDK Client from config/langsys.php and routes catalog caching through Laravel’s cache (any store — redis, memcached, file, array)
• A t() helper and @t Blade directive exposing the SDK’s {name} interpolation and ICU pluralization to Blade — the same phrase syntax as the Langsys JS SDKs, so one catalog serves your whole stack
• A DetectLocale middleware resolving the request locale (query → cookie → session → Accept-Language)
• A FlushPendingRegistrations terminable middleware (plus an Octane listener) that sends newly discovered phrases to Langsys after the response
• An opt-in TranslateResponse middleware that translates whole rendered HTML responses, for projects that want coverage without hand-tagging
• An InertiaSsrProps helper that seeds the JS SDKs’ initialTranslations for SSR handoff

In this package

Install Composer, .env, and locale/flush middleware for Laravel 10–12. Using translations @t, t(), interpolation, locale detection, Livewire, and flushing. Automatic translation Translate whole HTML responses without tagging every string. Inertia SSR Hand the JS SDKs the server's catalog so the client doesn't refetch it. Facade & client The Langsys facade and the underlying PHP SDK client. Configuration config/langsys.php and faking the client in tests.

Related packages

langsys/langsys-php PHP SDK Framework-agnostic client for the Langsys Translation API — phrase lookup, ICU interpolation, catalog caching, and full-page HTML translation. langsys/* All packages Back to the catalog.