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

nette-php-generator

/nette-php-generator

Opisuje generowanie kodu PHP z nette/php-generator: ClassType, InterfaceType, TraitType, EnumType, funkcje, metody, właściwości z hookami, PhpNamespace i PhpFile.

Repozytorium
agent-plugins ↗
Licencja
MIT
Ostatnia zmiana repozytorium
25.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
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 25.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

Opisuje generowanie kodu PHP z nette/php-generator: ClassType, InterfaceType, TraitType, EnumType, funkcje, metody, właściwości z hookami, PhpNamespace i PhpFile.

Oryginalny opis (EN)

Invoke before writing or reviewing code that generates PHP code with nette/php-generator. Covers ClassType, InterfaceType, TraitType, EnumType, GlobalFunction, Closure, Method, Parameter, Property with hooks and asymmetric visibility, PhpNamespace and its automatic class name resolution, PhpFile, Printer vs PsrPrinter, Literal, Type constants, attributes, the placeholders of setBody()/addBody(), loading existing code with from(), fromCode() and Factory, ClassManipulator and Dumper. Also trigger for code generators, scaffolding commands, DI container or proxy generation, and "generate a PHP cla

Jak działa

  1. Nette PhpGenerator
Sekcje z nagłówków SKILL.md, w oryginale · 82 linii, 653 słów
Podgląd SKILL.md
---
name: nette-php-generator
description: Invoke before writing or reviewing code that generates PHP code with nette/php-generator. Covers ClassType, InterfaceType, TraitType, EnumType, GlobalFunction, Closure, Method, Parameter, Property with hooks and asymmetric visibility, PhpNamespace and its automatic class name resolution, PhpFile, Printer vs PsrPrinter, Literal, Type constants, attributes, the placeholders of setBody()/addBody(), loading existing code with from(), fromCode() and Factory, ClassManipulator and Dumper. Also trigger for code generators, scaffolding commands, DI container or proxy generation, and "generate a PHP class/file". Not for Latte templates that output PHP, nor for nikic/php-parser AST work.
---

## Nette PhpGenerator

```shell
composer require nette/php-generator
```

Version 4.2 supports PHP 8.1 to 8.5 and generates the latest syntax (enums, readonly, property hooks, asymmetric visibility).

### Print the Namespace or the File, Not the Class

Code is modeled as objects and turned into a string by a printer: `echo $object` uses `Printer` (Nette style: tabs, brace of a method on its own line), `new PsrPrinter` produces PSR-12 / PER output. Pick the one the target project uses.

```php
$file = new Nette\PhpGenerator\PhpFile;
$file->setStrictTypes();                   // declare(strict_types=1)
$namespace = $file->addNamespace('App\Model');
$namespace->addUse(App\Entity\Product::class);
$class = $namespace->addClass('ProductRepository');

file_put_contents($path, (new Nette\PhpGenerator\PsrPrinter)->printFile($file));
```

A class that belongs to a namespace, printed on its own, has its names already shortened by the `use` clauses but carries neither the `namespace` line nor the `use` lines – the result does not compile. Print the `PhpNamespace` or the `PhpFile`. A `PhpFile` holds only namespaces, classes and functions; there is no API for other global code.

### Class Names Inside a Namespace Are Fully Qualified

A class added to a namespace has all its types **resolved**: parent, interfaces, traits, attributes, parameter, property and return types. Write every name fully qualified **without the leading backslash**; the printer shortens it by the `use` clauses and the current namespace, or prints `\Foo\Bar` when nothing applies.

```php
$method->addParameter('product')->setType('App\Entity\Product'); // printed as Product thanks to addUse()
$method->addComment('@return ' . $namespace->simplifyType('App\Entity\Product[]'));
```

Comments and bodies are **not** resolved – they are copied as written, so simplify names in them by hand (`simplifyName()`, `simplifyType()`). A class created by `new ClassType` outside any namespace gets no resolution; names are printed as written. `Printer::setTypeResolving(false)` turns resolution off.

### Bodies and Placeholders

`setBody($code)` and `addBody($line)` (one line per call) take PHP code as a string. With a second argument, an array, they fill placeholders by `Dumper`, which exports any value as valid PHP:

| Placeholder | Result |
|---|---|
| `?` | the value exported as PHP |
| `...?` | array items as arguments, `...?:` as named arguments |
| `$?`, `->?`, `::?` | a variable, property or static member of that name |
| `\?` | a literal `?` |

With arguments, **every** `?` not followed by a letter is a placeholder, including those in `??`, `?->` and `? :`. Write them as `\?\?`, `\?->` and `\? :`, or build that part of the code without arguments. Without arguments nothing is replaced and `\?` stays in the output literally.

```php
$method->setBody('return $this->db->table(?)->where(?, ?);', [$table, $column, $value]);
$method->addBody('return $x \?\? ?;', [$default]);
```

### Members

- `addProperty()`, `addMethod()`, `addConstant()` and `addTrait()` **throw** `InvalidStateException` when the member exists; the first three take `overwrite: true` to replace it. `addParameter()` overwrites silently.
- A default value is exported as data: `addProperty('mode', 'fast')` prints `'fast'`. For code (a constant, an expression, `new Foo`) pass `new Literal('self::Fast')` or `Literal::new(Foo::class, [$arg])`.
- `addProperty('list')->setType('?array')` has no default; `->setInitialized()` adds `= null`.
- Variadic is a flag of the **function**, not the parameter: `$method->setVariadic()` makes the last parameter variadic.
- Types are strings (`'?array'`, `'int|string'`) or `Type` constants and helpers: `Type::Array`, `Type::nullable(Type::String)`, `Type::union(...)`.
- Constructor promotion: `addMethod('__construct')->addPromotedParameter('name')->setType('string')->setPrivate()->setReadOnly()`. A readonly property or promoted parameter must have a type, otherwise printing throws.

### Reading Existing Code

```php
$class = ClassType::from(Foo::class);                    // by reflection, bodies are empty
$class = ClassType::from(Foo::class, withBodies: true);  // bodies too, needs nikic/php-parser
$file = PhpFile::fromCode(file_get_contents($path));     // needs nikic/php-parser
```

`fromCode()` keeps the file comment and `strict_types` but drops other global code and single-line comments outside bodies. To edit statements inside bodies, use nikic/php-parser directly. `ClassManipulator` adds `inheritMethod()`, `inheritProperty()` and `implement()` (stubs for every abstract member of an interface or abstract class).

`(new Dumper)->dump($value)` is a readable replacement for `var_export()` when generating configuration or cache files.

### Documentation

The full Nette documentation for this topic is bundled with the plugin. Read a page when you need details beyond this skill:

- [PhpGenerator](../../docs/php-generator/index.md) – every element, the printers, namespaces, files, loading existing code
- [PhpGenerator Upgrading](../../docs/php-generator/upgrading.md) – changes between major versions

Wersje

W bazie nie ma innych skilli o nazwie nette-php-generator.

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki bbc57059d063 (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-coding-standards
    Pilnuje standardów kodowania PHP w repozytoriach Nette: tabulatory, apostrofy, strict_types i kolejność importów.
  • 95php-8-3
    Pilnuje typowanych stałych klasy w PHP 8.3 i jawnej widoczności domyślnej przy pisaniu klas.
  • 100nette-command-line
    Opisuje pisanie skryptów wiersza poleceń PHP z nette/command-line 2.0: Command z addFlag, addOption, addArgument i addCommand, Parser, --help i --version, flagi negowalne i wartości domyślne.
  • 100php
    Podpowiada konwencje języka PHP, nowoczesne idiomy i system typów przy pisaniu, przeglądzie i refaktoryzacji kodu.
  • 100php-language-modern
    Pomaga pisać nowoczesny PHP 8.1-8.5 bez frameworka: property hooks, asymetryczna widoczność, operator pipe, atrybuty, enumy i readonly.
  • 95developing-with-php
    Opisuje nowoczesne programowanie w PHP 8.x: system typów, atrybuty, enumy, obsługę błędów i Composera.

Uwagi i zgłoszenia

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