4.0.0

4.0.0 - 2020-12-30

Added

• laminas/laminas-code#57 support for following PHP 8
  types have been added:
  • union types
  • false
  • mixed
  • null
  • static

Changed

• laminas/laminas-code#57 due to internal refactoring
  requiring better internal types, the minimum supported PHP version is now 7.4
• BC BREAK laminas/laminas-code#38 changed generated class
  output to no longer contain excessive whitespace around contents. The structure of the generated output
  will still be the same, but spacing changed, which will likely lead o breakages if you
  are asserting/depending upon the strings produced by Laminas\Code\Generator\ClassGenerator#generate()
• BC BREAK laminas/laminas-code#42 declare() statements
  will now be generated above namespace declarations: this is to be better compliant with PSR-2, but it
  may break downstream applications if these rely on the stability of code produced
  by Laminas\Code\Generator\FileGenerator#generate()

Removed

• BC BREAK zendframwork/zend-code#153 Removed
  the annotation API from the library
• BC BREAK laminas/laminas-code#39 the
  laminas/laminas-zendframework-bridge has been removed, and is instead to be installed optionally
  by consumers of the library. If you are still migrating from zendframework/zend-code, you will
  need to add it to your composer.json yourself, or directly use to Laminas\Code symbols.
• BC BREAK laminas/laminas-code#58 the Scanner
  and Annotation components have been removed, and with it all API that interacted with it:
  • Laminas\Code\Generator\FileGeneratorRegistry has been deleted
  • Laminas\Code\Generator\FileGenerator::fromReflectedFileName() was removed
  • Laminas\Code\Generator\FileGenerator::fromReflection() was removed
  • Laminas\Code\NameInformation has been deleted
  • Laminas\Code\Reflection\ReflectionInterface was marked @internal
  • Laminas\Code\Reflection\FileReflection has been deleted
  • Laminas\Code\Generic\Prototype\PrototypeInterface was marked @internal
  • Laminas\Code\Generic\Prototype\PrototypeClassFactory was marked @internal
  • Laminas\Code\Generic\Prototype\PrototypeGenericInterface was marked @internal
  • Laminas\Code\Annotation\AnnotationInterface has been deleted
  • Laminas\Code\Annotation\Parser\GenericAnnotationParser has been deleted
  • Laminas\Code\Annotation\Parser\ParserInterface has been deleted
  • Laminas\Code\Annotation\Parser\DoctrineAnnotationParser has been deleted
  • Laminas\Code\Annotation\AnnotationManager has been deleted
  • Laminas\Code\Annotation\AnnotationCollection has been deleted
  • Laminas\Code\Scanner\ValueScanner has been deleted
  • Laminas\Code\Scanner\DirectoryScanner has been deleted
  • Laminas\Code\Scanner\DocBlockScanner#$nameInformation was removed
  • Laminas\Code\Scanner\DocBlockScanner#$annotationManager was removed
  • Laminas\Code\Scanner\DocBlockScanner#$annotations was removed
  • Laminas\Code\Scanner\DocBlockScanner#getAnnotations() was removed
  • Laminas\Code\Scanner\DocBlockScanner was marked @internal
  • Laminas\Code\Scanner\ConstantScanner has been deleted
  • Laminas\Code\Scanner\FunctionScanner has been deleted
  • Laminas\Code\Scanner\AnnotationScanner has been deleted
  • Laminas\Code\Scanner\DerivedClassScanner has been deleted
  • Laminas\Code\Scanner\ClassScanner has been deleted
  • Laminas\Code\Scanner\AggregateDirectoryScanner has been deleted
  • Laminas\Code\Scanner\TokenArrayScanner has been deleted
  • Laminas\Code\Scanner\ParameterScanner has been deleted
  • Laminas\Code\Scanner\FileScanner has been deleted
  • Laminas\Code\Scanner\PropertyScanner has been deleted
  • Laminas\Code\Scanner\CachingFileScanner has been deleted
  • Laminas\Code\Scanner\ScannerInterface has been deleted
  • Laminas\Code\Scanner\MethodScanner has been deleted
  • Laminas\Code\Scanner\Util has been deleted

---

Release Notes for 4.0.0

next backward compatibility break release (major)

4.0.0

• Total issues resolved: 21
• Total pull requests resolved: 13
• Total contributors: 9

Enhancement

• 64: Verify 4.0.x branch against real-world applications before releasing thanks to @Ocramius
• 63: Feature - #62 upgrade coding standard and lock dependencies thanks to @Ocramius
• 61: fix #45 : Psalm integration thanks to @fezfez and @boesing
• 60: Remove travi-ci and move to github action thanks to @fezfez and @weierophinney
• 59: Merge release 3.5.1 into 4.0.x thanks to @github-actions[bot]
• 57: #53 support php-8.0 type system additions thanks to @Ocramius and @weierophinney
• 56: #48 merge release 3.5.0 into development branch for 4.0.x thanks to @Ocramius
• 10: Additional blank lines make generated class not PSR2 compliant thanks to @weierophinney

BC Break,Enhancement

• 58: BC BREAK: removed Scanner component, removed FileReflection, removed NameInformation and made DocBlockScanner @internal thanks to @Ocramius
• 39: Suggest "laminas/laminas-zendframework-bridge" thanks to @olvlvl
• 12: Remove code scanners to improve library maintainability thanks to @weierophinney

Duplicate,Enhancement

• 54: #53 added support for generating parameters with union types in their definitions thanks to @fezfez and @weierophinney
• 48: Merge release 3.5.0 into 4.0.x thanks to @github-actions[bot]

Bug

• 50: Some constants are not rendered properly depending on environment values thanks to @drupol

Bug,Unit Test Needed

• 42: Moved declare statements above namespace thanks to @jguittard

Awaiting Author Updates,BC Break

• 38: Generating class in a better format. thanks to @tiagosampaio

Bug,Duplicate,Won't Fix

• 28: DirectoryScanner->getClasses() returns no classes thanks to @weierophinney

Bug,Won't Fix

• 27: Zend\Code\Scanner\MethodScanner does not account for scalar type declarations thanks to @weierophinney
• 26: v3 only: Unknown Notices from ClassScanner thanks to @weierophinney
• 22: Update AnnotationScanner.php thanks to @weierophinney
• 18: Notice when using array as default value for parameter thanks to @weierophinney
• 15: E_NOTICE with trait method aliases thanks to @weierophinney
• 9: Zend\Code\Reflection\FileReflection getBody() thanks to @weierophinney
• 8: Zend\Code\Reflection\FileReflection crashes on Zend's module.config.php thanks to @weierophinney
• 3: Not using return value of array_map in ClassGenerator->setImplementedInterfaces thanks to @weierophinney

Question,Won't Fix

• 25: Use Reflection\FileReflection without including file? thanks to @weierophinney

Enhancement,Won't Fix

• 19: Support nullable types thanks to @weierophinney
• 1: perfect FunctionScanner class thanks to @weierophinney

BC Break,Enhancement,Question

• 17: Deprecate scanner functionality (4.0), drop it (5.0) in favor of thanks to @weierophinney