Класс модели в PHP: от простого к сложному

Как создать простую модель с прямыми SQL запросами на PDO?

Самый простой вариант - класс модели сам содержит методы для работы с БД через PDO. Подходит для небольших проектов.

class User {
    private static function getPdo(): \PDO {
        return new \PDO('mysql:host=localhost;dbname=test', 'root', '');
    }

    public static function find(int $id): ?self {
        $pdo = self::getPdo();
        $stmt = $pdo->prepare('SELECT * FROM users WHERE id = ?');
        $stmt->execute([$id]);
        $data = $stmt->fetch();
        if (!$data) return null;
        $user = new self();
        $user->id = $data['id'];
        $user->name = $data['name'];
        $user->email = $data['email'];
        return $user;
    }

    // ... аналогично save, delete
}

Как реализовать модель, которая сама управляет сохранением (ActiveRecord)?

Каждый объект модели является строкой в БД и содержит методы save(), delete(). Удобно для RAD.

abstract class ActiveRecord {
    protected static string $table;
    protected array $attributes = [];

    public function __get(string $key) { return $this->attributes[$key] ?? null; }
    public function __set(string $key, $value) { $this->attributes[$key] = $value; }

    public function save(): void {
        if ($this->attributes['id'] ?? false) {
            // UPDATE
        } else {
            // INSERT
        }
    }

    public static function find(int $id): ?self {
        // SELECT
    }
}

class User extends ActiveRecord {
    protected static string $table = 'users';
}

$user = new User();
$user->name = 'John';
$user->email = 'john@example.com';
$user->save();

Как использовать Eloquent ORM для быстрой разработки моделей?

Eloquent - встроенная ORM фреймворка Laravel. Позволяет объявить модель, просто унаследовавшись от Illuminate\Database\Eloquent\Model.

use Illuminate\Database\Eloquent\Model;

class User extends Model {
    protected $table = 'users';
    protected $fillable = ['name', 'email'];
}

// Использование
$user = User::find(1);
echo $user->name;

$user = new User();
$user->name = 'Jane';
$user->save();

Как использовать Doctrine ORM для enterprise приложений?

Doctrine - мощная ORM с DQL, аннотациями и полным отделением. Сущности описываются через аннотации или YAML/XML.

/**
 * @Entity
 * @Table(name="users")
 */
class User {
    /** @Id @Column(type="integer") @GeneratedValue */
    private int $id;

    /** @Column(type="string") */
    private string $name;

    /** @Column(type="string", unique=true) */
    private string $email;

    public function __construct(string $name, string $email) {
        $this->name = $name;
        $this->email = $email;
    }

    public function getId(): int { return $this->id; }
    public function getName(): string { return $this->name; }
    public function getEmail(): string { return $this->email; }
}

// Использование через EntityManager
$entityManager = EntityManager::create(/* настройки */);
$user = new User('Alice', 'alice@example.com');
$entityManager->persist($user);
$entityManager->flush();