PHPackages wyxos/shift-php - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. wyxos/shift-php ActiveLibrary[API Development](/categories/api) wyxos/shift-php =============== Laravel SDK to integrate and sync tasks with the SHIFT Dashboard. v1.1.78(1w ago)1256MITPHP Since May 5Pushed 2mo ago2 watchersCompare [ Source](https://github.com/wyxos/shift-php)[ Packagist](https://packagist.org/packages/wyxos/shift-php)[ RSS](/packages/wyxos-shift-php/feed)WikiDiscussions master Synced 1w ago READMEChangelogDependencies (5)Versions (129)Used By (0) SHIFT PHP for Laravel ===================== [](#shift-php-for-laravel) [![Latest Version on Packagist](https://camo.githubusercontent.com/1573d61abc37f3f2d202737bb1aece28149f9fd7c16791a96e14cc7f14c05239/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7779786f732f73686966742d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/wyxos/shift-php)[![MIT Licensed](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md) `wyxos/shift-php` adds issue reporting and task follow-up inside a Laravel application. It ships the `/shift` dashboard, an optional in-app report widget, task and thread routes, external collaborator lookup, browser-based installation, and cleaned backend error reporting. A Laravel app user reports an issue from the page where it happened, the package sends the page URL, route, environment, and user details to the portal, and the developer follows up on the resulting task. Installation ------------ [](#installation) ``` composer require wyxos/shift-php php artisan install:shift ``` The default installer uses browser verification: - Reads `APP_ENV` and `APP_URL` from the Laravel app. - Creates an install session in the portal. - Prints a verification URL and short code for browser approval. - Waits for approval through Reverb when available, with polling fallback. - Lets you choose a project or create one when the account has no available option. - Writes `SHIFT_TOKEN` and `SHIFT_PROJECT` to the app `.env`. - Registers the current app environment and URL. - Scaffolds `App\Services\ShiftCollaboratorResolver` when the app does not already have one. - Publishes config and frontend assets. If `SHIFT_TOKEN` and `SHIFT_PROJECT` already exist, the installer keeps those values and skips browser verification. For manual token setup, run: ``` php artisan install:shift --manual ``` Configuration ------------- [](#configuration) Typical `.env` values: ``` SHIFT_URL=https://shift.wyxos.com SHIFT_TOKEN=your-shift-api-token SHIFT_PROJECT=your-shift-project-token SHIFT_COLLABORATORS_RESOLVER=App\Services\ShiftCollaboratorResolver SHIFT_ERROR_REPORTING_ENABLED=true ``` Hosted portal: ``` SHIFT_URL=https://shift.wyxos.com ``` Local or self-hosted portal: ``` SHIFT_URL=https://shift.test ``` Local, `.test`, `.local`, localhost, and private IP portal URLs are treated as private by the package client, so SSL verification is skipped for package-to-portal requests. The active portal still needs network access to the app URL when it calls the app for collaborator lookup. Publish the config when you need to customize middleware, widget behavior, or error-reporting settings: ``` php artisan vendor:publish --tag=shift ``` Important config keys: ``` return [ 'token' => env('SHIFT_TOKEN'), 'project' => env('SHIFT_PROJECT'), 'url' => env('SHIFT_URL', 'https://shift.wyxos.com'), 'routes' => [ 'prefix' => 'shift', 'middleware' => ['web', 'auth'], ], 'widget' => [ 'enabled' => env('SHIFT_WIDGET_ENABLED', true), 'routes' => [ 'middleware' => ['web'], ], ], 'errors' => [ 'enabled' => env('SHIFT_ERROR_REPORTING_ENABLED', true), 'endpoint' => env('SHIFT_ERROR_REPORTING_ENDPOINT', '/api/errors'), 'timeout' => env('SHIFT_ERROR_REPORTING_TIMEOUT', 3), ], ]; ``` Task Creation From A Laravel App -------------------------------- [](#task-creation-from-a-laravel-app) After installation, the dashboard is available at: ``` /shift ``` It uses the configured route middleware, which defaults to `web` and `auth`. Authenticated users can create tasks, edit task details, comment in threads, upload attachments, and manage collaborators for the linked project. For a lightweight report form inside the host app, use the widget endpoint: ``` POST /shift/api/widget/tasks ``` Example browser submission: ``` await fetch('/shift/api/widget/tasks', { method: 'POST', credentials: 'same-origin', headers: { 'Content-Type': 'application/json', 'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]').content, }, body: JSON.stringify({ kind: 'issue', title: 'Invoice export does not download', description: 'I clicked Export CSV on invoice INV-1047 and no file downloaded.', anonymous: false, metadata: { page_url: window.location.href, page_title: document.title, referrer: document.referrer || null, }, }), }); ``` For the authenticated dashboard and task routes, the package passes these requests through to SHIFT: - `GET /shift/api/tasks` - `POST /shift/api/tasks` - `GET /shift/api/tasks/{id}` - `PUT /shift/api/tasks/{id}` - `PATCH /shift/api/tasks/{id}/collaborators` - `GET /shift/api/tasks/{taskId}/threads` - `POST /shift/api/tasks/{taskId}/threads` Backend Error Reports --------------------- [](#backend-error-reports) When `SHIFT_ERROR_REPORTING_ENABLED=true`, the package registers a Laravel exception reporter. It sends cleaned backend exception details to the configured portal without blocking the app's normal exception handling. The reporter never blocks the app. Missing credentials, disabled reporting, connection failures, timeouts, or failed portal responses are ignored. The package detects the revision from deployment commit metadata or the app Git checkout. If the checkout has an exact tag for that revision, the tag is sent as the release. Data Sent --------- [](#data-sent) Task and dashboard requests include: - Project token. - Authenticated app user name, email, and ID when available. - App environment from `APP_ENV`. - App URL from `APP_URL`. - User-entered task fields such as title, description, status, priority, comments, attachments, and collaborator choices. Widget submissions include: - Report kind, title, and description. - Anonymous flag. - Page details supplied by the widget, such as current page URL, page title, and referrer. - Authenticated app user details, or guest name/email when guest details are submitted and anonymous mode is not used. - Linked app name, environment, and URL. Backend error reports include: - Project token. - App environment, app URL, release, and revision. - Exception class and cleaned message. - Stack frames and limited source code for in-app files. - Request method, URL, path, referrer, IP, user agent, query, and body after scrubbing. - PHP and Laravel versions. - Authenticated user details when available. The error cleaner removes common sensitive fields such as password, token, authorization, and cookie values. You should still avoid adding secrets or sensitive customer data to task descriptions, widget details, or exception messages. Local Testing Path ------------------ [](#local-testing-path) ``` php artisan config:clear php artisan shift:test ``` `shift:test` creates a QA task in the configured project. Use a local or self-hosted portal unless you intentionally want that task in a hosted project. Troubleshooting --------------- [](#troubleshooting) ### `SHIFT configuration missing` [](#shift-configuration-missing) Run the installer or set both `SHIFT_TOKEN` and `SHIFT_PROJECT`, then clear cached config: ``` php artisan install:shift php artisan config:clear ``` ### Browser verification cannot run [](#browser-verification-cannot-run) The default installer needs an interactive terminal. In CI or non-interactive setup, obtain an API token and project token first, then run: ``` php artisan install:shift --manual ``` ### Local or private URL warning [](#local-or-private-url-warning) The installer warns when `APP_URL` is local or private. Task submission still works when the package can reach the portal, but external collaborator lookup requires that portal to reach the app's `/shift/api/collaborators/external` endpoint. ### `/shift` loads old assets or a blank UI [](#shift-loads-old-assets-or-a-blank-ui) In a consuming Laravel app, publish the current package assets: ``` php artisan shift:publish --group=public ``` ### Widget returns `401` or `403` [](#widget-returns-401-or-403) Check whether the portal project allows widget reports and whether guest submissions are allowed. If guest submissions are disabled, the app user must be authenticated through the configured widget guard. ### Task creation returns `422` [](#task-creation-returns-422) Check the validation response from the portal. Common causes are missing title/description, an invalid project token, or project configuration that does not allow the requested report path. ### Error reports do not appear [](#error-reports-do-not-appear) Check that error reporting is enabled and fully configured: ``` php artisan config:clear php artisan tinker >>> config('shift.errors.enabled') >>> config('shift.url') >>> filled(config('shift.token')) >>> filled(config('shift.project')) ``` The reporter is intentionally silent on network failures and failed portal responses so it does not interfere with application error handling. License ------- [](#license) MIT [Wyxos](https://wyxos.com). See [LICENSE.md](LICENSE.md) for details. ### Health Score 46 — FairBetter than 92% of packages Maintenance92 Actively maintained with recent releases Popularity17 Limited adoption so far Community8 Small or concentrated contributor base Maturity55 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~3 days Recently: every ~10 days Total 126 Last Release 11d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/23614232?v=4)[Wyxos](/maintainers/wyxos)[@wyxos](https://github.com/wyxos) --- Top Contributors [![wyxos](https://avatars.githubusercontent.com/u/23614232?v=4)](https://github.com/wyxos "wyxos (264 commits)") ### Embed Badge ![Health badge](/badges/wyxos-shift-php/health.svg) ``` [![Health](https://phpackages.com/badges/wyxos-shift-php/health.svg)](https://phpackages.com/packages/wyxos-shift-php) ``` ### Alternatives [exsyst/swagger A php library to manipulate Swagger specifications 35816.5M7](/packages/exsyst-swagger)[lucasdotvin/laravel-soulbscription A straightforward interface to handle subscriptions and features consumption. 709209.3k](/packages/lucasdotvin-laravel-soulbscription) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)