Php Generator Laravel Package

This release focuses on making namespaces and classes work together more naturally. Classes now know which namespace they belong to, constructors accept fully qualified names, and a new unified add() method on PhpFile ties it all together. Under the hood, the Factory got a thorough refactoring and the codebase passed its first mandatory static analysis check.

• PhpNamespace::add() now automatically assigns itself as the namespace of any ClassLike passed to it. If your code relied on getNamespace() returning null after adding a class to a namespace, you'll need to update that assumption.

• PhpFile::add() – a single entry point for adding classes, interfaces, traits, enums, functions, and namespaces to a file. It handles namespace creation and bracket syntax automatically, so you can build a complete file with just add() calls.

• ClassLike::getFullName() – returns the fully qualified name when the class belongs to a namespace (e.g., App\Model\User), the short name otherwise, or null for anonymous classes.

• ClassLike constructors now accept FQN – pass 'App\Model\User' and the namespace is extracted automatically. No need to create the namespace separately for simple cases.

• PhpNamespace::add() accepts GlobalFunction – the unified add() method now handles functions alongside class-like types, making the namespace API more consistent.

• The $namespace parameter in ClassLike constructors is deprecated. Use setNamespace() instead. The old signature still works for now, but will be removed in a future version.

This release focuses on making namespaces and classes work together more naturally. Classes now know which namespace they belong to, constructors accept fully qualified names, and a new unified add() method on PhpFile ties it all together. Under the hood, the Factory got a thorough refactoring and the codebase passed its first mandatory static analysis check.

• PhpNamespace::add() now automatically assigns itself as the namespace of any ClassLike passed to it. If your code relied on getNamespace() returning null after adding a class to a namespace, you'll need to update that assumption.

• PhpFile::add() – a single entry point for adding classes, interfaces, traits, enums, functions, and namespaces to a file. It handles namespace creation and bracket syntax automatically, so you can build a complete file with just add() calls.

• ClassLike::getFullName() – returns the fully qualified name when the class belongs to a namespace (e.g., App\Model\User), the short name otherwise, or null for anonymous classes.

• ClassLike constructors now accept FQN – pass 'App\Model\User' and the namespace is extracted automatically. No need to create the namespace separately for simple cases.

• PhpNamespace::add() accepts GlobalFunction – the unified add() method now handles functions alongside class-like types, making the namespace API more consistent.

• The $namespace parameter in ClassLike constructors is deprecated. Use setNamespace() instead. The old signature still works for now, but will be removed in a future version.

• requires PHP 8.1
• Visibility, PropertyHookType & PropertyAccessMode are enums (BC break)
• removed deprecated stuff
• addTrait() second argument is deprecated (BC break)

• support for PHP 8.5
• final promoted property in PHP 8.5
• optimized global function calls

• Factory::fromClassReflection() extracts property hook bodies (#172)
• Factory::fromClassReflection() rejects $withBodies for interfaces
• improved tests
• cs

• added support for PHP 8.4 features
  • properties hooks
  • asymmetric visibility
  • property can be abstract / final
  • interfaces can have properties
• added Visibility
• ClassManipulator::implement() can implement abstract classes
• ClassManipulator::implementInterface() renamed to implement()
• PsrPrinter is not final
• Constant: type can be nullable
• Factory: fixed visibility of promoted property

• Extractor::extractAll() fixed file comment parsing
• Factory: $withBodies cannot be used for internal classes/functions
• Printer: fixed falsy Attribute aren't printed (#142)
• added Visibility

• added ClassManipulator
• Parameter & Property: isNullable() returns true when default value is null (possible BC break)
• added TraitsAware::hasTrait method (#163)
• support for PHP 8.4

• added PhpNamespace::getClass() & getFunction()
• added CommentAware::removeComment()
• added PhpFile::removeNamespace()
• Factory, Extractor: sets flag readonly for promoted properties #158 (reverts "Factory: properties in readonly classes are not readonly")
• ClassType: cloning includes attributes and parameters
• GlobalFunction, Method: from() accepts first-class callables

• PsrPrinter: opening bracket on the correct line #155
• Make ClassLike::from return type assert the subclass type (BC break) (#154)
• Dumper::dumpArray(), dumpArguments() optimization
• Dumper: simplified list with negative keys
• added parameter $overwrite to addMember(), addMethod(), addProperty(), addConstant(), addCase() #152
• Factory: parameters 'int $foo = null' are parsed as '?int'

• Extractor: supports PHP-Parser 5.0 (#150)
• Extractor: fix escaping quotes when converting to double quoted string #151
• Extractor: NOWDOC/HEREDOC are not converted to single line strings
• Dumper: added $customObjects
• Dumper: refactoring, added dumpCustomObject()
• Printer: option $omitEmptyNamespaces is applied by printFile() [Close #147]

• Support union type in Type::nullable (#141)
• Extractor: fixed extracting of special arrays #143

• ClassType: added inheritMethod() & inheritProperty()
• Printer: added option $omitEmptyNamespaces
• added ConstantsAware::getConstant()
• Extractor::extractAll() extracts only top-level classes and functions, fixed file comment parsing
• Extractor: extracts native PHP values
• ClassType: getType() is deprecated
• Printer: fixed falsy Attribute aren't printed (#142)

• ClassType::class(), interface(), traits() & enum() are deprecated
• removed Nette\SmartObject
• removed deprecated stuff

• Parameters can have comments
• added Literal::new() #130
• fixed #135

• support for PHP 8.3
• Factory: properties in readonly classes are not readonly
• FunctionLike: added getParameter() & hasParameter()
• ConstantsAware: added hasConstant() (#133)

• Printer: added $singleParameterOnOneLine (#132)
• fixed class resolving in trait usages #128
• Printer: multiline attributes are in own attribute block
• Printer: attributes on parameters are placed on its own line
• coding style

• added support for typed constants
• Printer: print brace on next line when method/function has typehint
• Printer: promoted parameters / parameter with attributes are always multiline
• Printer: printAttributes & printReturnType are protected #123
• used PhpStorm Language attribute

• added support for PHP 8.2 features: DNF types, constants in traits, readonly classes, Type::True
• Type: constants are PascalCase
• Extractor: keeps the first comment in the method #119
• Printer: allow customizing comment formatting through protected printDocComment (#118)
• Helpers::formatDocComment() added option $forceMultiLine
• Factory: object class contains path from root namespace (#117)
• Extractor: Fixed extracting enum method body #115 (#116)
• PhpNamespace: better use-statements sorting behavior

• Extractor: keeps the first comment in the method #119
• Factory: object class contains path from root namespace (#117)
• Extractor: Fixed extracting enum method body #115 (#116)
• Type: constants are PascalCase

• support for PHP 8.2
• Dumper::dumpObject() refactoring
• Printer: added $linesBetweenUseTypes (#114)

• support for PHP 8.2
• Extractor: added support for Readonly promoted parameters (#111)

• Printer: added $bracesOnNextLine #112
• Extractor: added support for Readonly promoted parameters (#111)
• Printer: refactoring
• Dumper: supports __serialize()
• Dumper, Helpers::formatDocComment(), Printer::printFunction() & etc normalizes whitespace
• Printer: always prints trailing comma #106
• TraitType: traits cannot have constants

• ClassType divided into InterfaceType, TraitType & EnumType
• Enum: value can be expression
• Extractor: supports promoted parameters #103
• Extractor: maintains exact visibility
• PhpNamespace: added removeUse() #102
• constants are PascalCase
• strict fixes
• ClassType::__clone() clones traits

• Extractor: supports promoted parameters #103
• Extractor: maintains exact visibility
• PhpNamespace: added removeUse() #102
• constants are PascalCase
• ClassType::__clone() clones traits

This release takes advantage of all the new features of PHP 8 and cleans up some issues in the API.

• uses PHP 8 typehints & property typehints
• Dumper: prints comma after last argument

Stricter behaviour:

• ClassType::add*() throws exception when method/property/etc already exists
• PhpNamespace::add*() throws exception when class/function already exists

Changes:

• ClassType::addTrait() returns new class TraitUse instead of $this
• ClassType::getTraits() returns TraitUse[] instead of string[]
• Method: body is always string, even for interfaces
• ClassType::setConstants() and setTraits() accepts array of Constant resp TraitUse objects only

Deprecations:

• deprecated magic properties (BC break)
• ClassType::withBodiesFrom() replaced with from(..., withBodies: true)
• GlobalFunction::withBodyFrom() replaced with from(..., withBody: true)
• ClassType::from() & Factory::fromClassReflection(): removed parameter $materializeTraits

• Extractor: preserves the first comment in the file #100
• PhpNamespace: added removeClass() & removeFunction()
• coding style

This is the last 3.6.x release.

• PhpNamespace: added resolveName()
• Extractor: fixed extracting attributes #98
• PhpNamespace::addUse() ignores names in current namespace #96
• Dumper: improved encoding of strings

BLOG POST: https://blog.nette.org/en/phpgenerator-3-6-news-from-php-8-1-and-more

• use-statements for functions & constants
• ClassType: method names are case insensitive
• PhpNamespace: class and function names are case-insensitive
• PhpNamespace: addUse() & simplifyName() is case-insensitive
• PhpNamespace::simplifyName() fixed collision when alias already exists
• PhpNamespace: improved collision checking between class and alias
• PhpNamespace::addUse() removed parameter $aliasOut (BC break)
• PhpNamespace::addUse() simplified aliases generation
• Factory: supports 'new' in parameters
• accept numeric array keys when validating types #91

• Printer: added property $wrapLength #55 #56
• getType(), getReturnType(): added option $asObject that returns Nette\Utils\Type
• Factory: constant values are tagged for resolving
• Resolving of names in body & literals #85
• "use Trait" can have comments #90
• added TraitUse, represents use-statement
• PhpNamespace::simplifyType() supports generics like Foo<A, B>
• PhpNamespace::unresolveName() renamed to simplifyName()
• Helpers::unindent() fixed when level = 0
• Dumper::format() placeholder ? must not be followed by \w
• Dumper: added $indentation
• Dumper: refactoring
• Printer: refactoring, added property $dumper
• Printer: refactoring, added property $namespace
• Revert "Dumper: dumps Closure as PHP code" (BC break)
• PhpNamespace::addUse() added validation
• checks reserved class names
• added validator for types
• added Property and Parameter validation
• improved validation error messages
• Escapes */ in comments

• added ClassType::fromCode() & PhpFile::fromCode() #79
• Factory::fromClassReflection() added option to materialize traits or not #89
• PhpFile, PhpNamespace: can contain functions [Closes #80]
• PhpFile: added getClasses()
• Factory: generates trait resolutions
• ClassType: constants are 'public' by default
• Dumper: prints closures as func(...) in PHP 8.1