Deprecating all ::fromArray() methods in in the package

[Ocramius]

Q	A
Documentation	yes
Bugfix	no
BC Break	no
New Feature	no
RFC	no
QA	yes

Description

Deprecating all ::fromArray() methods in in the package

These methods are brittle, badly documented, and very much
type-unsafe.

The src/Generator API is mostly composed of builder objects,
and ::fromArray() is not necessary in it.

Please also do not use arbitrary user input, deserialized as
array, to generate code: it's a recipe for disaster.

[froschdesign]

Good decision. The configuration arrays are ugly to use and difficult to document.

Only one small suggestion.

[tyteen4a03]

Hi, will https://docs.laminas.dev/laminas-code/generator/examples/ be updated?

[Ocramius]

@tyteen4a03 by someone, yes: are you volunteering? 😁

[tyteen4a03]

@Ocramius I'm not sure what is needed from me because it looks like the docs in the repo are updated but the website doesn't render the latest version of the docs.

[Ocramius]

@tyteen4a03 aha! Thanks for checking: that's indeed for us to find out then /cc @froschdesign

[froschdesign]

The problem is the build process for the documentation: https://github.com/laminas/laminas-code/actions/workflows/docs-build.yml - but the logs are gone.

[froschdesign]

@tyteen4a03
The problem is solved: https://docs.laminas.dev/laminas-code/generator/examples/#generating-php-classes

Thanks to @Xerkus