Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

php-sql-conventions

/php-sql-conventions

Podpowiada konwencje zapytań SQL w PHP i Doctrine DBAL: kierunek zapytania od znanej encji, nowdoc i kolejność JOIN.

Licencja
MIT
Ostatnia zmiana repozytorium
12.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Podpowiada konwencje zapytań SQL w PHP i Doctrine DBAL: kierunek zapytania od znanej encji, nowdoc i kolejność JOIN.

Wyzwalacze z opisu

SQLqueryDBALJOINSELECT
Oryginalny opis (EN)

ACTIVATE when writing SQL queries in PHP code, using Doctrine DBAL, or formatting database queries. ACTIVATE for 'SQL', 'query', 'DBAL', 'JOIN', 'SELECT'. Covers: query direction convention (start from known entity), nowdoc formatting for SQL, column listing, JOIN ordering. DO NOT use for: Doctrine ORM/DQL, database migrations, general PHP code conventions.

Jak działa

  1. Query Direction
  2. Nowdoc Formatting for SQL
  3. SELECT Formatting
  4. JOIN Conventions
  5. Quick Reference
Sekcje z nagłówków SKILL.md, w oryginale · 119 linii, 474 słów
Podgląd SKILL.md
---
name: php-sql-conventions
description: "ACTIVATE when writing SQL queries in PHP code, using Doctrine DBAL, or formatting database queries. ACTIVATE for 'SQL', 'query', 'DBAL', 'JOIN', 'SELECT'. Covers: query direction convention (start from known entity), nowdoc formatting for SQL, column listing, JOIN ordering. DO NOT use for: Doctrine ORM/DQL, database migrations, general PHP code conventions."
---

# SQL Conventions

Conventions for SQL queries written in PHP code (Doctrine DBAL).

## Query Direction

**IMPORTANT**: Always start queries from the known/main entity and navigate to related entities via JOINs.

### Principle

When you have access to a specific entity (via ID or UUID), start the query from that entity's table and JOIN towards the data you need.

### Example

**Context**: You have a `$orderId` and want to fetch associated buyers.

```php
// Start from orders (known entity) -> navigate to buyer
FROM orders o
INNER JOIN shipping_group sg ON sg.id = o.shipping_group_id
INNER JOIN shipping_item si ON si.shipping_group_id = sg.id
INNER JOIN buyer b ON b.id = si.buyer_id
WHERE o.id = :order_id

// Start from buyer (unknown) -> navigate back to orders
FROM buyer b
INNER JOIN shipping_item si ON si.buyer_id = b.id
INNER JOIN shipping_group sg ON sg.id = si.shipping_group_id
INNER JOIN orders o ON o.shipping_group_id = sg.id
WHERE o.id = :order_id
```

### Why This Matters

1. **Readability**: The query follows the logical path from what you know to what you need
2. **Intent clarity**: The starting table indicates the entry point of the query
3. **Consistency**: Easier to maintain when all queries follow the same pattern

## Nowdoc Formatting for SQL

**IMPORTANT**: Follow [PER Coding Style - Section 10](https://www.php-fig.org/per/coding-style/#10-heredoc-and-nowdoc) for nowdoc/heredoc formatting.

See **[code-conventions skill](../php-code-conventions/SKILL.md#php-specific-heredoc--nowdoc-per-section-10)** for complete PER rules.

### SQL-Specific Rules

1. **Always use nowdoc** (`<<<'SQL'`) - never heredoc (`<<<SQL`) for SQL queries
2. Use prepared statement parameters (`:param`) instead of variable interpolation

### Correct Format

```php
$data = $connection->executeQuery(
    <<<'SQL'
        SELECT b.id, b.name
        FROM buyer b
        WHERE b.uuid = :uuid
        SQL,
    [
        'uuid' => $uuid,
    ],
    [
        'uuid' => UuidType::NAME,
    ],
)->fetchAssociative();
```

## SELECT Formatting

### Column Listing

One column per line for readability:

```php
<<<'SQL'
    SELECT
        b.id,
        b.first_name,
        b.last_name,
        BIN_TO_UUID(b.uuid) as uuid
    FROM buyer b
    SQL
```

### Aliasing

- Use short, meaningful table aliases (`b` for buyer, `o` for orders)
- Always prefix columns with table alias when multiple tables are involved
- Use `AS` for column aliases: `BIN_TO_UUID(b.uuid) AS uuid`

## JOIN Conventions

### Order

1. Start with the main/known table in FROM
2. JOIN tables in logical order following relationships
3. Use explicit JOIN type (`INNER JOIN`, `LEFT JOIN`)

### Example

```php
FROM orders o
INNER JOIN shipping_group sg ON sg.id = o.shipping_group_id
INNER JOIN shipping_item si ON si.shipping_group_id = sg.id
LEFT JOIN buyer b ON b.id = si.buyer_id
```

## Quick Reference

| Rule | Description |
|------|-------------|
| Query direction | Start from known entity, JOIN to needed data |
| Nowdoc syntax | Use `<<<'SQL'` (nowdoc), never `<<<SQL` (heredoc) |
| Nowdoc format | See [code-conventions](../php-code-conventions/SKILL.md#php-specific-heredoc--nowdoc-per-section-10) for PER rules |
| Column listing | One per line for multi-column SELECT |
| Table aliases | Short, meaningful, always prefixed |
| JOIN order | Follow logical relationship path |

Wersje

W bazie nie ma innych skilli o nazwie php-sql-conventions.

Migawka bazy z 13.11.2026 · wersja paczki 956fb869044c (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100php-code-conventions
    Stosuje konwencje stylu PHP przy pisaniu kontrolerów, serwisów i repozytoriów, z regułami dla operatora nullsafe i nowdoc.
  • 100doctrine-orm
    Wspiera pracę z Doctrine ORM 3 i DBAL 4 w Symfony: problemy N+1 i wolnych stron, wybór LAZY, EAGER i fetch join, kolejność migracji, blokowanie wierszy, importy wsadowe i utrata połączenia w workerach Messenger.
  • 95drizzle-conventions
    Pilnuje konwencji Drizzle ORM przy schematach pgTable, zapytaniach, migracjach i repozytoriach w TypeScript.
  • 100doctrine-patterns
    Stosuje dobre praktyki Doctrine ORM w Symfony: mapowanie encji, repozytoria, DQL i QueryBuilder z parametrami, zapobieganie N+1, relacje, zdarzenia cyklu życia, przetwarzanie wsadowe i migracje.
  • 100doctrine-query-optimization
    Optymalizuje zapytania Doctrine: usuwa problemy N+1, stronicuje duże zbiory wyników, buduje modele odczytu i stroi wydajność DQL oraz query buildera.
  • 100sql-query-conventions
    Ustala konwencje odczytu danych dla surowego SQL, PostgREST i ORM, czyli zapytań SELECT i projektu stronicowania.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.