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

php-code-conventions

/php-code-conventions

Stosuje konwencje stylu PHP przy pisaniu kontrolerów, serwisów i repozytoriów, z regułami dla operatora nullsafe i nowdoc.

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
2
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

Stosuje konwencje stylu PHP przy pisaniu kontrolerów, serwisów i repozytoriów, z regułami dla operatora nullsafe i nowdoc.

Wyzwalacze z opisu

coding standards
Oryginalny opis (EN)

ACTIVATE whenever writing or modifying PHP code in src/, creating controllers, services, repositories, specifications, or any production PHP class. ACTIVATE for code review, formatting questions, or 'coding standards'. Provides PHP-specific code style examples for the cross-language rules defined in craft:code-style-principles, plus PHP-specific rules (no empty(), nullsafe operator access, nowdoc, constructor parameter ordering with promoted properties). DO NOT use for: test code conventions (see phpunit:php-test-conventions), SQL formatting (see php-sql-conventions).

Jak działa

  1. PHP-specific: Nullsafe Operator ?->
  2. PHP-specific: NEVER Use empty()
  3. PHP-specific: Constructor Parameter Ordering
  4. PHP-specific: Heredoc / Nowdoc (PER Section 10)
  5. Quick Reference (PHP-specific only)
Sekcje z nagłówków SKILL.md, w oryginale · 61 linii, 357 słów
Podgląd SKILL.md
---
name: php-code-conventions
description: "ACTIVATE whenever writing or modifying PHP code in src/, creating controllers, services, repositories, specifications, or any production PHP class. ACTIVATE for code review, formatting questions, or 'coding standards'. Provides PHP-specific code style examples for the cross-language rules defined in craft:code-style-principles, plus PHP-specific rules (no empty(), nullsafe operator access, nowdoc, constructor parameter ordering with promoted properties). DO NOT use for: test code conventions (see phpunit:php-test-conventions), SQL formatting (see php-sql-conventions)."
---

# Code Conventions — PHP

> The **cross-language rules** (control-structure spacing, early return, continue vs if/else, parameter ordering, explicit checks, flatten null checks) are defined in `craft:code-style-principles`. This skill keeps PHP-specific syntax, PSR-12/PER extensions, and pointers to the project's `references/code-examples.md`.

All code complies with PSR-12 and PER Coding Style. The rules below are project-specific PHP conventions that go **beyond** these standards.

> **For complete worked examples** (control-structure spacing, early return, continue patterns, parameter ordering, heredoc/nowdoc), read `references/code-examples.md`.

## PHP-specific: Nullsafe Operator `?->`

Use `?->` to avoid nested null checks.

When using `match` with nullable input, add `null` as a case.

## PHP-specific: NEVER Use `empty()`

The `empty()` function has unpredictable behavior with different types and hides potential bugs.

| Type | Correct | Avoid |
|------|---------|-------|
| Arrays | `$array === []` | `empty($array)` |
| Strings | `$string === ''` | `empty($string)` |
| Null | `$value === null` | `empty($value)` |

## PHP-specific: Constructor Parameter Ordering

Mandatory parameters before optional; within each group, **promoted properties before simple parameters**:

1. Promoted mandatory (`public`/`private`/`protected`, required)
2. Simple mandatory (non-promoted, required)
3. Promoted optional (nullable promoted property)
4. Simple optional (nullable simple parameter)

> See `references/code-examples.md` for correct and incorrect examples.

## PHP-specific: Heredoc / Nowdoc (PER Section 10)

Reference: [PER Coding Style — Section 10](https://www.php-fig.org/per/coding-style/#10-heredoc-and-nowdoc)

**A nowdoc SHOULD be used wherever possible.** Heredoc MAY be used only when nowdoc does not satisfy requirements.

Indentation:
1. Declaration begins on the **same line** as its context.
2. Content is indented **once past the scope indentation**.
3. Closing identifier is at the **same indentation level as the content**.

> See `references/code-examples.md` for PER-compliant and non-compliant examples.

## Quick Reference (PHP-specific only)

> For the cross-language quick reference (early return, continue, blank lines, parameter ordering), see `craft:code-style-principles`.

| Rule | Example |
|------|---------|
| Nullsafe for nested null checks | `$a?->b?->c` instead of nested `if` |
| No `empty()` function | `$array === []` instead of `empty($array)` |
| Prefer nowdoc | `<<<'SQL'` instead of `<<<SQL` |
| Heredoc/nowdoc indentation | Content +1 level, closing same as content |
| Constructor params | Promoted-mandatory → simple-mandatory → promoted-optional → simple-optional |
Pliki w paczce (2)
  • SKILL.md 3 KB
  • references/code-examples.md 7 KB

Wersje

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

Migawka bazy z 13.11.2026 · wersja paczki a01ce1e32b25 (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

  • 100code-style-principles
    Stosuje bazowe zasady stylu kodu produkcyjnego w src/: odstępy przy strukturach sterujących, wczesny return, jawne sprawdzenia zamiast truthy/falsy, spłaszczanie zagnieżdżonych null checków i kolejność parametrów.
  • 100php-sql-conventions
    Podpowiada konwencje zapytań SQL w PHP i Doctrine DBAL: kierunek zapytania od znanej encji, nowdoc i kolejność JOIN.
  • 100php
    Podpowiada konwencje języka PHP, nowoczesne idiomy i system typów przy pisaniu, przeglądzie i refaktoryzacji kodu.
  • 100php-coding-standards
    Pilnuje standardów kodowania PHP w repozytoriach Nette: tabulatory, apostrofy, strict_types i kolejność importów.
  • 87php-conventions
    Stosuje nowoczesne idiomy PHP 8.1+: właściwości readonly, enumy, wyrażenia match, typowane właściwości, strict_types i styl PSR-12.
  • 100php-guide
    Przypomina zasady PHP: deklaracje typów, konwencje Composer i standardy PSR przy pracy z plikami .php i composer.json.

Uwagi i zgłoszenia

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