fix(task) #32 #33 #34 #35 #36 entity_manager option, readers re-executed for each input, table optional with sql, null input errors, lazy hydration

[njoubert-cleverage]

Description

Fixes #32.
Fixes #33.
Fixes #34.
Fixes #35.
Fixes #36.

Grouped in one PR because the fixes change the same tasks, tests, reference pages and the CHANGELOG Latest section (separate PRs would conflict).

• EntityManager tasks ignore the entity_manager option #32 AbstractDoctrineTask::getEntityManager() (new): the entity manager given by the entity_manager option (ManagerRegistry::getManager()), or the one managing the class when the option is not set (current behaviour). Used by every EntityManager task (reader, writer, batch writer, cleaner, detacher, refresher, remover).
• DatabaseReaderTask and DoctrineReaderTask skip one input out of two #33 DatabaseReaderTask::next() frees and drops the DBAL result, DoctrineReaderTask::next() drops the iterator, when the iteration ends: the next input executes the query again (it was skipped).
• DatabaseReaderTask requires the table option even when sql is given #34 DatabaseReaderTask: table is optional, and only required when sql is not set (checked on initialization).
• DoctrineDetacherTask and DoctrineRemoverTask wrong error on a null input #35 DoctrineDetacherTask error message fixed; DoctrineRemoverTask throws a \RuntimeException on a null input, as the other tasks.
• DoctrineReaderTask hydrates every entity before outputting the first one #36 DoctrineReaderTask keeps the toIterable() iterator (iterator_to_array() was only added for typing in 82fe912): entities are hydrated one at a time.

Tests

• DatabaseReaderTaskSqliteTest (new): DatabaseReaderTask on an in-memory SQLite database, iterating as the process manager does. It covers table, sql without table, neither of them, three inputs, pagination with two inputs, input_as_params, and an ArrayParameterType parameter.
• AbstractDoctrineTaskTest (new): entity manager selection, through DoctrineWriterTask.
• DoctrineReaderTaskTest: entities hydrated while iterating, query executed again for each input.
• Existing tests: states now give their (empty) options; null input messages.

54 tests; the new ones fail without the fix (11 errors / failures). The 2 PHPUnit deprecations were already reported on main.

Documentation: entity_manager option of every EntityManager task, table option, notes of both readers (the "executed once per process run" limitation is removed, memory usage of DoctrineReaderTask), index.md, export cookbook (no more table placeholder with sql).

Checked with process-bundle-demo (see the demo PR):

Process	Before	After
demo.doctrine.database.read_multiple_inputs	6 rows + Empty resultset	9 rows
demo.doctrine.entitymanager.reader_multiple_inputs	6 entities + Empty resultset	9 entities
demo.doctrine.database.read_sql_without_table	The required option "table" is missing.	3 rows
demo.doctrine.entitymanager.reader_entity_manager (entity_manager: 'unknown')	entities read with the default entity manager	Doctrine ORM Manager named "unknown" does not exist.
demo.doctrine.entitymanager.detacher_null_input	DoctrineWriterTask does not allow null input	DoctrineDetacherTask does not allow null input
demo.doctrine.entitymanager.remover_null_input	get_class(): Argument #1 ($object) must be of type object, null given	DoctrineRemoverTask does not allow null input
demo.doctrine.database.read, read_paginate	3 rows / 2 pages	unchanged

demo.doctrine.database.read_array_parameter also validates the !php/enum Doctrine\DBAL\ArrayParameterType::… example of database_reader_task.md with DBAL 4.4.

Requirements

• Documentation updates
  • Reference
  • Changelog
• Unit tests

Breaking changes

• EntityManager tasks ignore the entity_manager option #32: configurations setting entity_manager on an EntityManager task now use that entity manager (the option was ignored); a wrong name now fails.
• DatabaseReaderTask and DoctrineReaderTask skip one input out of two #33: a reader receiving several inputs now outputs the rows / entities for each of them (one input out of two was skipped).
• DoctrineDetacherTask and DoctrineRemoverTask wrong error on a null input #35: the exception on a null input changes (the task already failed).

🤖 Generated with Claude Code