# PHPSandbox Documentation

> Build, run, inspect, preview, and publish PHP applications in isolated sandboxes.

The workspace and SDK are two interfaces to the same sandbox platform. Use the workspace for interactive browser development and the SDK for applications, integrations, automation, and agents.

## Start here

- [Introduction](https://phpsandbox.io/docs.md): Understand the workspace, SDK, and shared sandbox model.
- [Workspace quickstart](https://phpsandbox.io/docs/getting-started/workspace.md): Create and run your first sandbox from the browser workspace.
- [SDK quickstart](https://phpsandbox.io/docs/getting-started/sdk.md): Create and control your first sandbox from an application or integration.

## Sandbox concepts

- [Sandboxes](https://phpsandbox.io/docs/concepts/sandboxes.md): Understand the shared environment behind the workspace and SDK.
- [Lifecycle](https://phpsandbox.io/docs/concepts/runtime.md): Learn how a sandbox is prepared, becomes ready, stops, restarts, and is removed.
- [Previews and sharing](https://phpsandbox.io/docs/concepts/previews.md): Open a running product in the browser and share its live URL.
- [Security model](https://phpsandbox.io/docs/concepts/security.md): Understand isolation, credentials, network controls, and safe preview sharing.
- [Persistence and limits](https://phpsandbox.io/docs/concepts/persistence-and-limits.md): Design for sandbox persistence, resource limits, cleanup, and recoverable failures.
- [Project setup](https://phpsandbox.io/docs/concepts/project-setup.md): Configure repeatable installs, commands, tasks, services, environment values, and preview ports.

## Workspace

- [Create or import](https://phpsandbox.io/docs/workspace/create-or-import.md): Start from a template, GitHub repository, ZIP archive, or existing sandbox.
- [Workspace tools](https://phpsandbox.io/docs/workspace/tools.md): Use files, terminals, Composer, mail, environment settings, and previews.
- [Files and terminals](https://phpsandbox.io/docs/workspace/files-and-terminals.md): Edit product files, search a project, and run interactive terminal commands.
- [Dependencies and environment](https://phpsandbox.io/docs/workspace/dependencies-and-environment.md): Install Composer and JavaScript dependencies and configure runtime values safely.
- [Previews and mail](https://phpsandbox.io/docs/workspace/previews-and-mail.md): Open product ports, inspect outgoing mail, and share a running result safely.
- [Version control](https://phpsandbox.io/docs/workspace/version-control.md): Review changes, create commits, work with branches, and synchronize a remote repository.

## SDK

- [Authentication and clients](https://phpsandbox.io/docs/sdk/authentication-and-clients.md): Protect API tokens, choose a runtime transport, and handle API failures.
- [End-to-end automation](https://phpsandbox.io/docs/sdk/automation-workflow.md): Create, modify, verify, and preview a Laravel sandbox.
- [Managing sandboxes](https://phpsandbox.io/docs/sdk/lifecycle.md): Create, open, fork, stop, restart, and delete SDK-managed sandboxes.
- [Filesystem](https://phpsandbox.io/docs/sdk/filesystem.md): Read, write, search, watch, move, and download sandbox files.
- [Commands and processes](https://phpsandbox.io/docs/sdk/processes.md): Run one-shot commands, stream processes, and open interactive terminals.
- [Secrets and environment](https://phpsandbox.io/docs/sdk/secrets-and-environment.md): Manage runtime secrets and Composer credentials without placing values in source code.
- [Integrations](https://phpsandbox.io/docs/sdk/integrations.md): Connect external providers once and reuse their authorization across supported SDK operations.
- [Previews](https://phpsandbox.io/docs/sdk/previews.md): Find preview URLs and create protected sessions and handoffs.
- [Browser Beacon](https://phpsandbox.io/docs/sdk/beacon.md): Inspect, diagnose, navigate, and capture a sandbox preview from a browser iframe.
- [Git](https://phpsandbox.io/docs/sdk/git.md): Review changes, checkpoint work, synchronize repositories, and clone a sandbox.
- [Services and observability](https://phpsandbox.io/docs/sdk/services-and-observability.md): Run services and inspect logs, ports, metrics, and mail.
- [Publish a sandbox](https://phpsandbox.io/docs/publishing.md): Turn a working sandbox into a managed deployment.