core php

Laravel/PHP development tools with FrankenPHP.

Commands

Development

Command	Description
dev	Start development environment
logs	View service logs
stop	Stop all services
status	Show service status
ssl	Setup SSL certificates with mkcert

Build & Production

Command	Description
build	Build Docker or LinuxKit image
serve	Run production container
shell	Open shell in running container

Code Quality

Command	Description
test	Run PHP tests (PHPUnit/Pest)
fmt	Format code with Laravel Pint
analyse	Run PHPStan static analysis

Package Management

Command	Description
packages link	Link local packages by path
packages unlink	Unlink packages by name
packages update	Update linked packages
packages list	List linked packages

Deployment (Coolify)

Command	Description
deploy	Deploy to Coolify
deploy:status	Show deployment status
deploy:rollback	Rollback to previous deployment
deploy:list	List recent deployments

---

php dev

Start the Laravel development environment with all detected services.

core php dev [flags]

Services Orchestrated

• FrankenPHP/Octane - HTTP server (port 8000, HTTPS on 443)
• Vite - Frontend dev server (port 5173)
• Laravel Horizon - Queue workers
• Laravel Reverb - WebSocket server (port 8080)
• Redis - Cache and queue backend (port 6379)

Flags

Flag	Description
--no-vite	Skip Vite dev server
--no-horizon	Skip Laravel Horizon
--no-reverb	Skip Laravel Reverb
--no-redis	Skip Redis server
--https	Enable HTTPS with mkcert
--domain	Domain for SSL certificate (default: from APP_URL)
--port	FrankenPHP port (default: 8000)

Examples

# Start all detected services
core php dev

# With HTTPS
core php dev --https

# Skip optional services
core php dev --no-horizon --no-reverb

---

php logs

Stream unified logs from all running services.

core php logs [flags]

Flags

Flag	Description
--follow	Follow log output
--service	Specific service (frankenphp, vite, horizon, reverb, redis)

---

php stop

Stop all running Laravel services.

core php stop

---

php status

Show the status of all Laravel services and project configuration.

core php status

---

php ssl

Setup local SSL certificates using mkcert.

core php ssl [flags]

Flags

Flag	Description
--domain	Domain for certificate (default: from APP_URL or localhost)

---

php build

Build a production-ready container image.

core php build [flags]

Flags

Flag	Description
--type	Build type: docker (default) or linuxkit
--name	Image name (default: project directory name)
--tag	Image tag (default: latest)
--platform	Target platform (e.g., linux/amd64, linux/arm64)
--dockerfile	Path to custom Dockerfile
--output	Output path for LinuxKit image
--format	LinuxKit format: qcow2 (default), iso, raw, vmdk
--template	LinuxKit template name (default: server-php)
--no-cache	Build without cache

Examples

# Build Docker image
core php build

# With custom name and tag
core php build --name myapp --tag v1.0

# Build LinuxKit image
core php build --type linuxkit

---

php serve

Run a production container.

core php serve [flags]

Flags

Flag	Description
--name	Docker image name (required)
--tag	Image tag (default: latest)
--container	Container name
--port	HTTP port (default: 80)
--https-port	HTTPS port (default: 443)
-d	Run in detached mode
--env-file	Path to environment file

Examples

core php serve --name myapp
core php serve --name myapp -d
core php serve --name myapp --port 8080

---

php shell

Open an interactive shell in a running container.

core php shell <container-id>

---

php test

Run PHP tests using PHPUnit or Pest.

core php test [flags]

Auto-detects Pest if tests/Pest.php exists.

Flags

Flag	Description
--parallel	Run tests in parallel
--coverage	Generate code coverage
--filter	Filter tests by name pattern
--group	Run only tests in specified group

Examples

core php test
core php test --parallel --coverage
core php test --filter UserTest

---

php fmt

Format PHP code using Laravel Pint.

core php fmt [flags]

Flags

Flag	Description
--fix	Auto-fix formatting issues
--diff	Show diff of changes

---

php analyse

Run PHPStan or Larastan static analysis.

core php analyse [flags]

Flags

Flag	Description
--level	PHPStan analysis level (0-9)
--memory	Memory limit (e.g., 2G)

---

php packages link

Link local PHP packages for development.

core php packages link <path> [<path>...]

Adds path repositories to composer.json with symlink enabled.

---

php packages unlink

Remove linked packages from composer.json.

core php packages unlink <name> [<name>...]

---

php packages update

Update linked packages via Composer.

core php packages update [<name>...]

---

php packages list

List all locally linked packages.

core php packages list

---

php deploy

Deploy the PHP application to Coolify.

core php deploy [flags]

Configuration

Requires environment variables in .env:

COOLIFY_URL=https://coolify.example.com
COOLIFY_TOKEN=your-api-token
COOLIFY_APP_ID=production-app-id
COOLIFY_STAGING_APP_ID=staging-app-id

Flags

Flag	Description
--staging	Deploy to staging environment
--force	Force deployment even if no changes detected
--wait	Wait for deployment to complete

---

php deploy:status

Show the status of a deployment.

core php deploy:status [flags]

Flags

Flag	Description
--staging	Check staging environment
--id	Specific deployment ID

---

php deploy:rollback

Rollback to a previous deployment.

core php deploy:rollback [flags]

Flags

Flag	Description
--staging	Rollback staging environment
--id	Specific deployment ID to rollback to
--wait	Wait for rollback to complete

---

php deploy:list

List recent deployments.

core php deploy:list [flags]

Flags

Flag	Description
--staging	List staging deployments
--limit	Number of deployments (default: 10)

---

Configuration

Optional .core/php.yaml - see Configuration for examples.