Maintenance – Added order by in search function

[derpixler]

#Added sort_by and order_by parameters to search()

Based on #43 by @mostafaqanbaryan — thanks for the initial contribution!

References

• Zammad REST API — Search via API

What it does

Adds sort_by and order_by as optional parameters to Resource\AbstractResource::search(), allowing search results to be sorted server-side via the Zammad REST API:

$tickets = $client->resource(ResourceType::TICKET)->search(
    'my query',
    null,           // page (auto-paginate)
    null,           // per_page
    'created_at',   // sort_by
    'desc'          // order_by
);

Changes

• search() and searchWithoutPagination() both accept $sort_by and $order_by as optional parameters (backwards compatible)
• $order_by validated — must be "asc" or "desc", throws \RuntimeException otherwise
• Tag::search() signature updated for parent class compatibility
• Full PHPDoc coverage for all new parameters

Thanks

@mostafaqanbaryan for the original PR #43

[mgruner]

Can we have some test coverage here, please?