Silverstripe SDK

Quick setup for talaria/silverstripe — Composer, TALARIA_API_KEY, Monolog, and the first error. HTTP, MySQL, Guzzle, queued jobs, and the browser script.

talaria/silverstripephpinstallinit

talaria/silverstripe (2.0.1) is the Silverstripe 4.13, 5, and 6 module on PHP 8.1. Injector builds the client and pushes a Monolog handler onto the framework logger. Do not call Talaria::init() yourself.

Quick setup

bash

composer require talaria/silverstripe

text

TALARIA_API_KEY=tal_live_…
TALARIA_RELEASE=1.4.2

The DSN defaults to https://ingest.newtalaria.com. Set Talaria\SilverStripe\Config.dsn in YAML only when the API is somewhere else. Flush the manifest after install (vendor/bin/sake dev/build flush=1, or your usual flush). Log an error or throw. Confirm with MCP search_errors and environment: development.

What you can do

Capability	Where
Monolog errors and logs, breadcrumbs, and the current Member	Errors, logs, and breadcrumbs
HTTP middleware, MySQL, Guzzle, and queued jobs	Instrumentation and tracing
PHP analytics, feature flags, and the injected browser script	Best practices
Move between module versions	Upgrade

CMS and public pages load @newtalaria/browser. Replay, heatmaps, web vitals, and consent run in that script. Public pages can send browser analytics. The CMS is not opted into analytics. There is no Redis wrapper. Silverstripe has no core Redis usage this module instruments. Use the PHP Redis proxy if you added Redis yourself.

Install

bash

composer require talaria/silverstripe

Initialization

YAML and environment are the setup. The module reads:

Variable or YAML	Role
`TALARIA_API_KEY`	Ingest key. Chooses the environment
`TALARIA_RELEASE`	Version or SHA
`TALARIA_DSN`	Optional. Default `https://ingest.newtalaria.com`
`TALARIA_BROWSER_DSN`	Browser script only, when the PHP DSN is not reachable from the browser
`TALARIA_BROWSER_API_KEY`	Browser script only. PHP keeps `apiKey`
`enableBrowserCms` / `enableBrowserFrontend`	Default true

minLevel defaults to warning.

App init vs Project settings

Tracing, analytics, heatmaps, and replay follow Project configuration. The CMS admin is not opted into browser analytics. Public pages can send analytics through the injected script when the project allows it.

API key

Use a development key locally and a production key on the live site. The prefix stays tal_live_. A non-empty TALARIA_BROWSER_API_KEY that is not a tal_live_ key disables browser inject. Leave it unset to share the PHP key.

Verification

Trigger a logged error. search_errors with environment: development. Flush caches so the new module config is loaded.

Troubleshooting

A rejected key is cached for about 24 hours. Restart PHP-FPM after rotating it. If the browser script is missing, check enableBrowserFrontend and that the response is a normal HTML page.