Derafu DEV

// A normal class with a normal method. The #[Operation] attribute is all it takes
// to publish "build" as an operation: no controller and no command class.
class InvoiceBuilderWorker extends AbstractWorker implements WorkerInterface
{
    #[Operation]
    public function build(string $number, int $amount): array
    {
        // Your business logic.
    }
}

// From here, the same operation can be called as an HTTP endpoint (described in
// OpenAPI 3.1), as a console command, or from Python, by its id.

// A form is data. The schema says what the data is and which fields are required;
// the UI schema says how the fields are laid out. It is rendered on the server.
$definition = [
    'schema' => [
        'type' => 'object',
        'properties' => [
            'name' => ['type' => 'string', 'title' => 'Full Name'],
            'email' => ['type' => 'string', 'format' => 'email'],
        ],
        'required' => ['name', 'email'],
    ],
    'uischema' => [
        'type' => 'VerticalLayout',
        'elements' => [
            ['type' => 'Control', 'scope' => '#/properties/name'],
            ['type' => 'Control', 'scope' => '#/properties/email'],
        ],
    ],
];

// The user writes the filter (in the URL of a data table, for example) as a single
// expression. This one means "customers that have an invoice over 1000":
//
//   customers __ invoices[on:id=customer_id] __ total ? >1000
//   first table   join and its condition       column   filter
//
$qb->where('customers__invoices[on:id=customer_id]__total?>1000');

// The builder writes the rest:
//   FROM customers
//   INNER JOIN invoices ON customers.id = invoices.customer_id
//   WHERE invoices.total > :param      (1000 is sent as a bound parameter)

// $yaml is a UBL document (here, a Quotation) written in YAML, following the
// OASIS "UBL JSON Alternative Representation". JSON and XML work the same way.
// The result is a typed PHP object of the UBL version you use, not an array.
$quotation = (new Deserializer())->deserialize($yaml, 'yaml');

// Read it or change it as plain PHP, then write it as the official UBL XML.
$xml = (new Serializer())->serialize($quotation, 'xml');