Download the PHP package thamibn/laravel-periscope without Composer
On this page you can find all versions of the php package thamibn/laravel-periscope. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download thamibn/laravel-periscope
More information about thamibn/laravel-periscope
Files in thamibn/laravel-periscope
Package laravel-periscope
Short Description Laravel adapter for php-periscope — wires Telescope-tier observability events into the periscope C extension's trace. Time-travel debugging, SQL/log/cache/job inspection, and an AI-native MCP server in one package.
License MIT
Homepage https://periscope.thamibn.com
FAQ
Example:
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 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.
Informations about the package laravel-periscope
php-periscope
🚧 Under active development — alpha. This is a pre-release greenfield project. Things will move, break, and change shape. If you find this and want to try it, expect rough edges and please file issues. Production use is not recommended yet.
See into your Laravel request.
A live observability + time-travel debugger built for Laravel. Pause any request, see every variable, query, log, job, event, cache hit, Redis command, and HTTP call that led to that line — and scrub backward in time. Xdebug-tier debugging plus Telescope-tier observability, in one live UI, with an AI co-pilot.
Status: v0.1.4. All twelve plan phases shipped — C extension, Rust daemon, SolidJS UI, Laravel adapter, MCP server (AI-native), install/uninstall scripts, PECL package, VSCode extension scaffold, Homebrew formula, docs site, CI workflows. Real-world test harness (Phase 10) is next.
Quickstart
Install — pick one:
Both build the C extension against your PHP, drop the daemon binaries into your prefix, and write 99-periscope.ini so the extension auto-loads. Pick whichever you'd run for any other CLI tool.
Windows: use WSL2 with Ubuntu, then run the Linux command above inside Ubuntu. Native Windows is not supported in v1 — see the FAQ for why and the Windows setup section for the one-time wsl --install step.
Then in your Laravel app:
Full setup walk-through, including the Homebrew tap and the VSCode extension: Getting Started →
What it does
| Today's tools | What they do | Limitation |
|---|---|---|
| Xdebug | Breakpoints + variables | No observability; no time-travel; setup pain |
| Telescope | Queries / logs / jobs / events | Post-mortem only |
| DebugBar | Live observability | Tiny footer; no breakpoints; no time-travel |
php-periscope merges all three into one live UI with time-travel as a first-class feature.
Benchmark vs Xdebug (from docs/POSITIONING.md): 3.3× faster inactive, 4.1× faster in trace mode.
Architecture
- C extension using Zend Observer API (PHP 8.3+) — engine hooks, variable capture, Cap'n Proto trace recording.
- Rust daemon speaking Debug Adapter Protocol — works in VSCode, Neovim, Zed, Helix, JetBrains.
- Browser UI (SolidJS) at
localhost:9999— source, variables, queries, logs, jobs, timeline scrubber, flame graph, insights, AI suggestions. - Laravel adapter (Composer package
thamibn/laravel-periscope) — auto-discovers Laravel events; ships the floating toolbar chip, the in-app UI mount, and the first-party MCP server for AI agents. - VSCode extension — registers a
periscopedebug type, auto-spawns the daemon, status-bar liveness chip. - Cap'n Proto trace format — zero-copy on read so the timeline scrubber stays imperceptible.
See docs/site/guide/architecture.md for the deep dive.
v1 scope
- Laravel only (12.x / 13.x). The C extension is framework-agnostic; Symfony / WordPress / CodeIgniter / plain-PHP adapters are post-v1.
- PHP 8.3 / 8.4 • macOS + Linux • Local development only (no production sampling in v1).
- Function-boundary recording, not opcode-level — overhead < 5× even on hot paths.
- No telemetry, no SaaS — traces stay on disk; the MCP server is local-only over stdio.
See docs/SCOPE.md for the full in / out list.
Documentation
The full docs site (VitePress) is under docs/site/. It auto-deploys to Cloudflare Pages on every push to main once the deploy secrets are configured.
Quick links:
- Getting started
- Architecture
- Known limitations
- FAQ
- Roadmap
Source-of-truth docs in the repo:
- Positioning vs Xdebug
- Implementation plan — the phased plan of record.
AI-native
Eight MCP tools expose every trace to AI agents: list_traces, get_trace, get_summary, get_insights, get_timeline, get_state (time-travel), query_events (with JSON-path filter language), read_file. No other PHP debugger lets Claude / Cursor / Codex query traces this directly.
Built on Laravel 13's first-party laravel/mcp SDK.
Trace storage and privacy
Each request writes one .cptrace file to periscope.trace_dir (default /tmp/periscope/, ~5KB–500KB per request depending on call volume).
Automatic retention runs at the start of every request:
| INI knob | Default | Behaviour |
|---|---|---|
periscope.max_traces |
100 |
Keep newest N traces; delete the rest. Set to 0 to disable. |
periscope.max_trace_age_seconds |
86400 (24h) |
Delete traces older than this. Set to 0 to disable. |
Manual cleanup from the CLI or the UI's Storage panel:
Privacy: traces capture request bodies, cookies, headers, and captured variables. They may contain credentials. Don't commit them. Don't post them in public bug reports without periscope-export <id> --format json redaction. The C extension already strips a default set of header names (Authorization, Cookie, Set-Cookie) — see docs/SCOPE.md for the full redaction policy.
Contributing
We welcome contributions. Read CONTRIBUTING.md first — it covers per-subsystem dev setup, coding standards, the ASan / Valgrind workflow, and the commit + PR rules (no AI co-author attribution, no GPG signing required, make ci clean before pushing).
- Report a bug: bug report template.
- Report a process exit / crash: crash report template — please fill every field; we can't triage process exits without the stack trace + environment + extension list.
- Suggest a feature: feature request template with a v1 / v1.1 / v2+ scope checkbox.
- Ask a question: GitHub Discussions.
- Conduct: Contributor Covenant 2.1.
Feedback funnel (beta)
- GitHub Discussions — open-ended questions, design ideas, "is this a bug or am I holding it wrong?" → https://github.com/thamibn/php-periscope/discussions.
- GitHub Issues — concrete, reproducible bugs and crashes. Use the templates.
- Security disclosures — privately email the maintainer (see
composer.jsonleadblock). Response within 7 days. - Discord (planned for v0.3 public beta) — invite link will land here.
[email protected](planned) — for one-off prose feedback that doesn't fit an issue. Until the alias goes live, route prose through GitHub Discussions.
Licence
Proprietary — all rights reserved. The licensing model may change before public release. See LICENSE.
All versions of laravel-periscope with dependencies
illuminate/contracts Version ^12.0 || ^13.0
illuminate/support Version ^12.0 || ^13.0