Společnost

Integrace databází a ORM v PHP: srovnání Doctrine a Eloquent

Ladislav B. 0

Integrace databází a ORM v PHP

Integrace databází je v ekosystému PHP jedním z nejčastějších úkolů. Volba přístupu – od „čistého“ PDO přes query builder až po plnohodnotné ORM (Object–Relational Mapping) – zásadně ovlivňuje bezpečnost, výkon, udržovatelnost i rychlost vývoje. Tento článek shrnuje architektonické styly, klíčové koncepty ORM, výhody a nevýhody různých přístupů, best practices, výkonové optimalizace a specifika nejrozšířenějších frameworků (Laravel, Symfony, Nette, Laminas, Yii).

Architektonické styly práce s databází

  • PDO (low-level přístup): Ruční psaní SQL, připravené dotazy, plná kontrola nad výkonem i transakcemi. Vhodné pro vysoce optimalizované části, reporting a složité dotazy.
  • Query Builder: Fluent API pro skládání SQL (dbal, Eloquent Builder, NetteDatabaseExplorer, LaminasDbSql). Snižuje riziko chyb a zvyšuje čitelnost, ale stále zachovává blízkost SQL.
  • ORM: Mapování tabulek na entity a vztahy, Unit of Work, Identity Map, lazy/eager loading, migrace. Typicky Doctrine ORM (Symfony), Eloquent (Laravel), Cycle ORM, Propel, Atlas.

Vzor ORM: Active Record vs. Data Mapper

  • Active Record: Třída entity nese metody save(), find(), delete() (např. Eloquent, Yii AR). Jednodušší pro CRUD, hůře škáluje u složitých doménových modelů.
  • Data Mapper: Oddělení doménového modelu od perzistence (např. Doctrine). Vyšší flexibilita pro DDD, avšak složitější konfigurace.

Klíčové koncepty ORM

  • Entity a hodnotové objekty: Entity mají identitu (primární klíč), hodnotové objekty jsou neidentitární a neměnné.
  • Unit of Work a Identity Map: Sledování změn nad entitami a zabránění duplicitním instancím představujícím tentýž databázový řádek.
  • Vztahy: OneToOne, OneToMany, ManyToMany; kardinality a vlastnictví vztahu (owning/inverse side) ovlivňují generované SQL dotazy.
  • Načítání dat: Lazy vs. eager loading; strategie jako join fetch, select in, subselect.
  • Životní cyklus entity: stavy new, managed, detached, removed; životní události (prePersist, postLoad apod.).

Bezpečnost: SQL injection a práce s daty

  • Připravené dotazy: Vždy používejte parametrizaci (?/:name), nikdy neskládejte SQL řetězce z neověřených vstupů.
  • Escapování vs. parametrizace: Parametrizace má vždy přednost; escapování je doplňkové a chybové scénáře se mohou lišit napříč ovladači.
  • Serializace JSON/XML: Při ukládání dokumentů do sloupců používejte validaci schématu, limity velikosti a indexy (např. GIN pro JSONB).
  • Princip nejmenších oprávnění: Aplikační účet s omezenými právy (SELECT/INSERT/UPDATE/DELETE pro konkrétní schéma), oddělené uživatelské role pro migrace.

Transakce a izolace

  • Granularita: Obalujte logické jednotky práce (service nebo use-case) do transakcí; v ORM používejte EntityManager::transactional() (Doctrine) či DB::transaction() (Laravel).
  • Izolační úrovně: READ COMMITTED, REPEATABLE READ, SERIALIZABLE; volba ovlivňuje riziko „phantoms“ a „non-repeatable reads“.
  • Deadlocky: Implementujte idempotentní retry s exponenciálním zpožděním a auditováním.

Migrace schématu a verzování

  • Nástroje: Doctrine Migrations, Laravel Migrations, Phinx; verzujte spolu s kódem a CI/CD pipeline.
  • Bezvýpadkové změny: Přidávejte nové sloupce jako NULL nebo s výchozí hodnotou, provádějte backfill v dávkách, následně zpřísněte na NOT NULL.
  • Seed/fixtures: Deterministická testovací data; oddělujte dev seed od produkční inicializace.

Výkon a optimalizace (ORM i SQL)

  • N+1 dotazy: Používejte eager loading (with() v Eloquent, JOIN FETCH v Doctrine) a dávkové načítání (batching).
  • Indexy: Měřte a přidávejte kompozitní indexy dle reálných dotazů; sledujte EXPLAIN plány.
  • Pagination a streaming: Keyset pagination (přes >/<) je efektivnější než OFFSET pro velké tabulky; využijte kurzory.
  • Cache: Aplikační cache (Redis, Memcached), 2nd-level cache (Doctrine), query cache tam, kde je to bezpečné.
  • Bulk operace: Dávkové insert/update s vypnutím sledování změn v ORM (clear, detach) a využitím native queries pro masivní operace.
  • Asynchronní běh: V kombinaci se Swoole/RoadRunner využijte persistentní připojení a pooly; dejte pozor na stavovost ORM objektů mezi požadavky.

Doménové modelování a repozitáře

  • Repository pattern: Zapouzdřuje dotazy nad agregáty, udržuje doménový kontrakt; v Doctrine lze implementovat vlastní Repository třídy.
  • Specifikace a CQRS: Náročné čtecí dotazy přesuňte do read-modelů (DTO/projekce) a oddělte od zápisového modelu.
  • Event sourcing: V doménách vyžadujících audit zvažte ukládání událostí; projekce denormalizujte do tabulek pro čtení.

Podpora typů a moderní PHP

  • Typed properties a readonly: Zvyšují spolehlivost entit; vyžadují opatrnost při lazy-loading proxích.
  • Enum a backed enum: Mapujte na malé tabulky či ENUM sloupce; v Doctrine/Eloquent jako custom typy nebo CASTy.
  • Atributy: Konfigurace ORM přes PHP atributy místo anotací či YAML; přehlednější a typově bezpečnější přístup.
  • Statická analýza: Psalm/PHPStan s generiky (phpdoc) pro kolekce; odhaluje nekompatibilní dotazy ještě před nasazením.

Práce s více databázemi, replikace a škálování

  • Read/Write splitting: Zápisy na master, čtení z replik; pozor na replication lag a konzistenci po zápisu (sticky sessions, read your write).
  • Sharding: Logická distribuce dat (uživatelé, tenanti) podle klíče; repozitáře rozhodují o konkrétním shardu.
  • Multi-tenant: Izolace per tenant (schéma/tabulky) vs. sdílené tabulky s tenant_id a row-level security.

Práce s NoSQL a speciálními typy

  • JSON/JSONB: Mapujte na DTO a validujte; využívejte indexy pro často dotazované cesty (->, ->>, #>).
  • Geodata: PostGIS; v Doctrine vlastní typy pro geometry, v Eloquent casty a kontrola SRID.
  • Fulltext: MySQL InnoDB FULLTEXT/Boolean mode nebo specializovaný vyhledávač (OpenSearch, Meilisearch) se synchronizací událostí.

Zpracování změn: concurrency a audit

  • Optimistické zámky: Sloupec version/updated_at pro detekci konfliktů; ORM vyhodí výjimku při kolizi.
  • Pessimistické zámky: SELECT ... FOR UPDATE pro ochranu kritických sekcí; nezapomeňte na timeouty.
  • Audit trail: Listeners/subscribers logují změny; ukládejte dify nebo celé snímky dle potřeby.

Testování a izolace

  • Transakce na test: Obalte test do transakce a na jejím konci proveďte rollback; rychlé a izolované testy.
  • Fixtures a factories: Vytvářejte data přes doménové API; neobcházejte validační logiku.
  • Integrace vs. unit testy: Složitější dotazy testujte integračně proti skutečné DB (např. v kontejnerech), doménovou logiku pak unit testy se stuby repozitářů.

Integrace ve frameworkech

  • Laravel (Eloquent): Active Record, migrations, seeder, factories, globální i scoped query, casts, události modelů; snadné eager loading a withCount().
  • Symfony (Doctrine ORM): Data Mapper, EntityManager, Repository, QueryBuilder, hydrátory, 2nd-level cache; bohatý ekosystém nástrojů.
  • Nette (Database/Explorer, integrace Doctrine): Lehký query builder a mapování na řádkové objekty; pro DDD se často kombinuje s Doctrine.
  • Laminas (Db): SQL builder, adaptéry, TableGateway; vhodné pro projekty preferující explicitní SQL.
  • Yii (Active Record): Podobné Eloquentu s propracovaným with() a scénáři validace.

Logování a observabilita

  • SQL log: Zapněte logování dotazů s parametry a trváním; v produkci používejte opatrně (sampling).
  • Tracing: OpenTelemetry/Jaeger; anotujte hranice (repozitáře, transakce), přidejte DB span atributy (db.system, statement, rows).
  • Performance budget: Definujte SLA pro latenci dotazů a počet round-tripů na request.

Typické anti-patterny a jak se jim vyhnout

  • Mass assignment bez whitelistu: V Eloquent používejte $fillable/$guarded; v Doctrine validujte DTO před hydratací.
  • Business logika v kontrolerech: Přesuňte ji do služeb a domény; kontroler volá use-case.
  • N+1 a eager loading všude: Vždy měřte; někdy je vhodnější explicitní SQL s agregací.
  • Neřízený lazy-loading v šablonách: Generuje nestabilní latenci; připravte data v aplikační vrstvě.

Roadmapa implementace v projektu

  1. Volba přístupu: Definujte, kde použijete ORM, kde query builder a kde nativní SQL.
  2. Model a hranice: Navrhněte entity, agregáty, repozitáře, transakční hranice a politiky načítání.
  3. Migrace a seed: Nastavte nástroje, konvence verzování a CI pipeline pro migrační kroky.
  4. Bezpečnost: Parametrizace, role v DB, audit dotazů a přístupů, testy proti injection útokům.
  5. Výkon: Indexy, eager loading, cache, keyset pagination, sledování spouštěcích plánů.
  6. Testy: Strategie pro unit a integrační testy, transakční testy, fixtures.
  7. Observabilita: SQL log, tracing, metriky a alerty.

Tabulkové srovnání přístupů

Ladislav B.

Website:

Related Story
Přístup Kontrola nad SQL Produktivita Složitost Vhodné pro
PDO Maximální Nižší Nižší Výkonnostně citlivé části, reporting
Query Builder Vysoká Střední Střední CRUD s komplexními filtry
ORM – Active Record Střední Vysoká Střední Rychlé CRUD, malé až střední domény