Leaf 5: App Config & Deployment Reference

Environment Variables

Auto-loaded in MVC. In basic apps, use vlucas/phpdotenv or symfony/dotenv to load .env.

$value = _env('SECRET_KEY', 'default-if-not-found');

---

Application Mode

app()->config(['mode' => 'production']);

Or set APP_ENV in .env, Leaf detects it automatically.

Run code only in a specific mode:

app()->script('production', function () {
    // only runs in production
});

In Blade:

@env('production')
  {{-- only renders in production --}}
@endenv

Production Checklist

• Set all environment variables for production
• Turn off debug mode so errors aren't rendered to your users

---

Logging

Pre-configured in MVC. Logs saved to storage/logs/ by default.

Basic apps:

leaf install logger

app()->config([
    'log.enabled' => true,
    'log.dir'     => __DIR__ . '/logs/',
    'log.file'    => 'app.log',   // default: log.txt
]);

To disable logging entirely:

leaf uninstall logger

---

rescue(): Safe Execution

$value = rescue(function () {
    // code that may throw
}, 'default value');

rescue(function () {
    // code that may throw — no return value needed
});

---

Maintenance Mode

// Basic app
app()->config(['app.down' => true]);

// MVC — set in .env
// APP_DOWN=true

Custom down page:

app()->setDown(function () {
    echo 'Custom maintenance page!';
});

---

Service Container

Register once, fetch anywhere on the Leaf instance. This is service location by design (not constructor injection); re-registering a name replaces it, which is how tests swap in fakes.

app()->register('something', function ($c) {
    return new Something();
});

$something = app()->something;
$something->doSomething();

// or
app()->something->doSomething();

---

URL Rewriting

Map all requests to index.php so Leaf's router handles them.

Nginx:

try_files $uri /index.php?$query_string;

Apache (.htaccess):

RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule . index.php [L]

---

Deployment

Vite / Inertia Apps

Build assets before deploying:

npm run build   # or yarn build / pnpm build

Skipping this causes a broken app or CORS errors with Inertia. Add to your deploy script.

Queues / Workers

Quick start (small apps):

php leaf queue:work &

Production (recommended), use Supervisor:

sudo apt update && sudo apt install supervisor -y
sudo nano /etc/supervisor/conf.d/leaf-queue.conf

[program:leaf-queue]
process_name=%(program_name)s_%(process_num)02d
command=php leaf queue:work
autostart=true
autorestart=true
numprocs=1
redirect_stderr=true
stdout_logfile=/var/log/leaf-queue.log

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start leaf-queue
sudo supervisorctl status leaf-queue