PHP app

Your PHP code served by PHP's built-in server, from files or a GitHub repo. No image to build.

app
language

Guides: Run your own app, Run a GitHub repo

Run it

briq_run({
  recipe: "php",
  params: {
    "version": "8.4",
    "port": 8080,
    "env": {},
    "size": "small"
  },
  wait: true
})

curl -X POST https://api.briq.cloud/v1/briqs \
  -H "Authorization: Bearer $BRIQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipe": "php",
    "params": {
      "version": "8.4",
      "port": 8080,
      "env": {},
      "size": "small"
    },
    "wait": true
  }'
# → { "briqs": [{ "id": "bq_…", … }], "outputs": { "APP_URL": "…" }, … }

# ... when done, for each briq id
curl -X DELETE https://api.briq.cloud/v1/briqs/<id> \
  -H "Authorization: Bearer $BRIQ_API_KEY"

Parameters

Name	Type	Options	Default
version	enum	8.4, 8.3	"8.4"
files	record	{ "path": "content" \| { base64 } }	—
repo	object	{ url, ref?, dir?, token? }	—
install	string	—	—
build	string	—	—
start	string	—	—
port	number	—	8080
env	record	{ NAME: "value" \| { secret, value? } }	{}
size	enum	nano, small, medium, large	"small"
diskGb	number	—	—

Outputs

Returned by briq_run once the stack is healthy. Hosts resolve inside your team network; secrets are generated per run.

APP_URL: http://app.<stack>.internal:8080

What it runs

Briq	Image	Ports	Size	Volume
app	php:8.4-cli	8080	small	—

When to use it

A handful of PHP pages or a small API, served without Apache, nginx or an image to build.

Tips

Code in a repo: pass repo: { url: "github.com/owner/app" } instead of files. See Run a GitHub repo.
Pass the code as files: { "index.php": "…" }. Relative paths go under /app, the document root, written before the server starts and again whenever it starts over.
Served by PHP's built-in server on $PORT (8080 by default), IPv6 and IPv4.
No Composer in the image: include vendor/ in files, or install Composer with install.
Publish it as you run it with expose: "private" (or "public" for anyone): it returns URL.
Step by step: Run your own app, with a database and a URL.

Go app

Your Go code running as a service, from files or a GitHub repo: it builds the module and starts the binary. No image to build.

Ruby app

Your Ruby code running as a service, from files or a GitHub repo: it bundles the Gemfile and starts it. No image to build.