Website · Documentation · Getting started · Download
Run a PHP web application as a desktop or mobile application. Your Symfony, Laravel or plain PHP project opens in a native window. PHP runs inside the application process and answers the window directly, so no web server is involved and no port is opened. The window is the system webview, through Tauri, so the application ships neither Electron nor Node.
Nativella started as a proof of concept of PHP, Rust and Tauri in one process, to find out if a Tauri window could hand its requests to PHP through a SAPI written in Rust. The proof of concept is the first commit of this repository, with its measurements and what it ran into, such as WebKitGTK handling neither cookies nor redirects on a custom scheme. The rest of the project was built on top of it.
system webview ──php://localhost/…──▶ Tauri scheme handler (Rust)
│ public/ file? ─▶ served from disk
▼
PHP thread ── cookie jar, redirects, URL rewriting
│
▼
custom SAPI (ext-php-rs) ─▶ public/index.php
│ │
native events ─────▶│◀──── nativella_call() ──────┘
▼
windows, menus, tray, dialogs, clipboard, notifications…
- It runs any PHP application with a
public/index.php. Symfony and Laravel have integrations, and plain PHP works too. - PHP gets native APIs for windows, application and context menus,
the tray icon, dialogs, notifications, the clipboard, global shortcuts,
settings, secrets, timers, child processes, power, screens and the shell,
and receives typed native events (
MenuItemClicked,WindowFilesDropped…). Phones add haptics, geolocation, biometrics, a barcode scanner, NFC tags and the share sheet. - The state lives in an SQLite database in the application's data directory, migrated when the application starts (Doctrine, Eloquent).
- To distribute it,
nativella buildwrites one executable that carries the project and PHP, so the machine does not need PHP. - The same project builds into an Android APK and an iOS app, experimentally, without Android's or Apple's tools.
Nativella is young and experimental, and is developed on Linux. Read Limitations and roadmap first.
Download nativella, for Linux x86_64 or
macOS arm64, then, from a clone of the repository:
(cd demos/symfony && composer install)
nativella run demos/symfonyOr build it from source, in Docker, with Castor, as the releases are:
castor static-php:build # PHP 8.5 as a static library, once
castor nativella:build # dist/nativella, with PHP inside, and the demoscastor start, then castor qa, runs the checks. See
Developing Nativella.
To write your own application, Getting started goes from an empty directory to a desktop application.
| Path | What |
|---|---|
crates/runtime |
The runtime: the SAPI, the PHP thread, static files, cookies, redirects, and nativella_call(). Framework and GUI agnostic. |
crates/nativella |
The shell and the nativella command: Tauri windows, the native methods (src/native/), events, standalone and mobile bundles. |
packages/nativella |
nativella/nativella: the PHP API (Nativella\Window, Dialog, Menu…), the events, the fake client for tests. |
packages/symfony |
nativella/symfony-bundle: services, Symfony events, migrations at boot, profiler panel. |
packages/laravel |
nativella/laravel: service provider, facades, Laravel events, migrations at boot. |
demos/symfony |
Nativella Notes: Symfony 8, Doctrine, menus, tray, context menus, drag and drop. Runs on Android and iOS too. |
demos/laravel |
Nativella Tasks: Laravel 13, Eloquent. |
demos/vanilla |
Nativella Snippets: no framework, Doctrine DBAL. |
mobile |
What the Android and iOS builds need besides their Castor tasks: the stand-ins that describe PHP for the phone to ext-php-rs. |
static-php |
Where the Castor tasks build PHP as a static library, for the desktop and for the phones. |
website |
The public website: the landing page, generated by PHP, and the documentation of docs, built by Zensical. |
MIT, see LICENSE.