Yii2 InertiaModern single-page apps with classic Yii controllers

The Inertia.js v3 adapter for Yii 2. Build React, Vue or Svelte frontends without writing an API.

Get started

Installation

View on GitHub

🚀

Zero configuration

The inertia component registers and bootstraps itself. Render your first page with one line in a controller.

📡

Complete v3 protocol

Partial reloads, deferred, optional, once, merge and infinite scroll props, flash data, error bags, history encryption and fragment redirects.

🧩

Made for Yii

Yii redirects, CSRF validation, JSON form bodies, validation errors from models and data providers work out of the box.

⚡

Vite built in

Asset tags from the build manifest or the dev server with hot module replacement, React Fast Refresh and CSP nonces.

🖥️

Server-side rendering

Render the first visit on the server through the Inertia SSR server or the Vite dev server, with automatic fallback.

✅

Tested

A test suite covering the protocol on PHP 8.1 to 8.5, verified against a real application with React 19.

At a glance

php

use Crenspire\Yii2Inertia\Inertia;

class UserController extends \yii\web\Controller
{
    public function actionIndex(): \yii\web\Response
    {
        return Inertia::render('Users/Index', [
            'users' => fn () => User::find()->select(['id', 'name', 'email'])->asArray()->all(),
        ]);
    }
}

jsx

// src/pages/Users/Index.jsx
export default function Index({ users }) {
  return (
    <ul>
      {users.map((user) => <li key={user.id}>{user.name}</li>)}
    </ul>
  )
}

Continue with the introduction or jump straight to installation.