README

Yii 1.1 Active Record, extracted and modernized for PHP 8.4+.

Familiar API. Zero framework lock-in.

What is it?

This package is the Active Record component from Yii 1.1, extracted and refactored to run on PHP 8.4+ without requiring the full Yii framework.

• ✅ Same API you know from Yii 1
• ✅ PHP 8 types and attributes support
• ✅ No Yii::app() dependency
• ✅ Works with any PSR-11 compatible container

Requirements

• PHP ≥ 8.4
• PSR-11 ContainerInterface (required)
• Optional PSR dependencies (if used in your app):
  • Psr\Log\LoggerInterface
  • Psr\SimpleCache\CacheInterface
  • Psr\EventDispatcher\EventDispatcherInterface

Installation

composer require yii1x/active-record

Bootstrap

Before using any model, initialize the ORM context once per application lifecycle:

use Yii1x\ActiveRecord\ORMContext;

ORMContext::bootstrap($container, debug: false);

Where $container is your PSR-11 container.

The container must be able to return a configured database connection instance by name (e.g., 'db' or 'yourDbName').

This can be:

• An instance of Yii1x\ActiveRecord\Db\DbConnection
• Any class extending DbConnection

Example configuration (from Yii 3):

<?php
return [
    'db_name' => [
        'class' => \Yii1x\ActiveRecord\Db\DbConnection::class,
        '__construct()' => [
            'dsn' => 'mysql:host=db;port=3306;dbname=yii3',
            'username' => 'root',
            'password' => 'root',
            'connectionName' => 'db_name',
        ],
    ],
];

Then in your models, specify which connection to use:

#[Database(name: 'db_name')]
class User extends ActiveRecord
{
    // ...
}

Define a Model

Use PHP 8 attributes instead of class properties:

use Yii1x\ActiveRecord\ActiveRecord;
use Yii1x\ActiveRecord\Attributes\Table;
use Yii1x\ActiveRecord\Attributes\Database;

#[Table(name: 'user')]
#[Database(name: 'db_name')]
class User extends ActiveRecord
{
    public function relations(): array
    {
        return [
            'posts' => [self::HAS_MANY, Post::class, 'user_id'],
        ];
    }
}

Querying (familiar Yii 1 style)

// Find one
$user = User::model()->findByAttributes(['email' => 'test@example.com']);

// new fluent query builder
$users = User::queryBuilder()
    ->where('status', 1)
    ->orderBy('created_at DESC')
    ->limit(10)
    ->with('posts')
    ->findAll();

Framework Agnostic

Works with any PSR-11 container (as shown in the Yii 3 example above).

No Yii framework required. No global state. Just Active Record.