Yii3 InertiaModern single-page apps with Yii3

The Inertia.js server-side adapter for Yii3 and any PSR-15 application. Use React, Vue or Svelte while routing, controllers and validation stay in PHP.

Get started

Installation

View on GitHub

🚀

Inertia.js 3 protocol

Partial reloads, deferred, optional, merge, once and infinite scroll props, with support for Inertia.js 1 and 2 clients.

⚙️

Zero-config Yii3 setup

Services register themselves through yiisoft/config. Add the middleware, create a root view, and render pages.

📝

Forms and validation

Validation errors with error bags, flash data across redirects, and CSRF protection that works with yiisoft/csrf.

⚡

Vite built in

Script and stylesheet tags from the dev server or the build manifest, React Fast Refresh, and automatic asset versioning.

🖥️

Server-side rendering

Render pages in Node.js through a PSR-18 HTTP client, with automatic fallback to client-side rendering.

🔁

Worker safe

Stateless services and request-scoped data, ready for RoadRunner, Swoole and FrankenPHP.

Quick look

Return a page component and its props from a Yii3 action. Expensive data can load after the page renders:

php

use Crenspire\Inertia\Inertia;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
use Yiisoft\Router\CurrentRoute;

final readonly class ShowAction
{
    public function __construct(
        private Inertia $inertia,
        private UserRepository $users,
    ) {}

    public function __invoke(ServerRequestInterface $request, CurrentRoute $route): ResponseInterface
    {
        $id = (int) $route->getArgument('id');

        return $this->inertia->render($request, 'Users/Show', [
            'user' => $this->users->get($id),
            'activity' => Inertia::defer(fn () => $this->users->activity($id)),
        ]);
    }
}

The React page receives the props. <Deferred> shows a fallback until activity arrives:

jsx

import { Deferred, Head } from '@inertiajs/react'

export default function Show({ user, activity }) {
  return (
    <>
      <Head title={user.name} />
      <h1>{user.name}</h1>
      <Deferred data="activity" fallback={<p>Loading activity…</p>}>
        <ActivityList items={activity} />
      </Deferred>
    </>
  )
}

Ready to start? Install the package and follow the installation guide:

bash

composer require crenspire/yii3-inertia:^2.0