ZendHQ 2.4.0

New features

  • Added PHP 8.5 support to the ZendHQ PHP extension.
  • ZendHQ now has a UUID identifying the installation.
    • The UUID is generated when the ZendHQ daemon is started for the first time and stored in the database. The UUID can be used to identify the ZendHQ installation in logs, monitoring, and other places.
    • The UUID can be retrieved using the session.system_uuid JsonRPC method.
  • Added new Job Queue JsonRPC API methods:
    • jq.export_queue and jq.export_queues JsonRPC methods can be used to export Job Queue queue definitions and job definitions to a JSON document.
    • jq.import_queue and jq.import_queues JsonRPC methods can be used to import Job Queue queue definitions and job definitions from a JSON document.
    • jq.import_jobs JsonRPC method can be used to import Job Queue job definitions to an existing queue from a JSON document.
    • jq.suspend_queues and jq.activate_queues JsonRPC methods can be used to suspend or activate all the Job Queue queues at once.
    • jq.are_queues_suspended JsonRPC method can be used to check if all the Job Queue queues are suspended.
    • jq.test_cron JsonRPC method can be used to test a cron expression and get the next scheduled run times.
  • Added new sub-commands to the zendhqctl jobqueue queue command:
    • zendhqctl jobqueue queue export sub-command can be used to export Job Queue queue definitions and job definitions to a JSON file.
    • zendhqctl jobqueue queue import sub-command can be used to import Job Queue queue definitions and job definitions from a JSON file.
    • zendhqctl jobqueue job import sub-command can be used to import Job Queue job definitions to an existing queue from a JSON file.
  • Added new functions to the Job Queue PHP API:
    • ZendHQ\\JobQueue\\HTTPJob::getQueryStringArguments() function can be used to get the query string arguments of an HTTP job as an associative array.
  • Added support for multiple Open ID Connect (OIDC) providers.
    • ZendHQ daemon now supports multiple OIDC providers that can be configured in the ZendHQ daemon's configuration file. OIDC provider configuration is now generic and can be configured to support any OIDC provider.
  • Added zendhqinfo() PHP function to the ZendHQ PHP extension.
    • The zendhqinfo() function outputs information about the ZendHQ PHP extension, tries to ping the ZendHQ daemon and outputs the daemon connection status.
  • Added zendhq.log_file_cli directive to the ZendHQ PHP extension's configuration file that can be used to set the log file path for PHP CLI SAPI.
  • If the directive is not set, then the zendhq.log_file directive is used.

Changes

  • Modified zendhqctl jobqueue queue suspend/activate sub-commands to support the --all-queues flag that can be used to suspend or activate all the Job Queue queues at once.
  • Modified zendhqctl jobqueue job history sub-command to support --time-from, --time-to and --date flags that can be used to filter job history entries by completion time range.
  • Modified the jq.get_job_history JsonRPC method to support time_from and time_tofilter parameters that can be used to filter job history entries by completion time range.
  • Modified the oauth2.providers JsonRPC method to optionally return full provider information if the full parameter is set to true.
  • Modified session.create, session.restore and session.id JsonRPC methods to return authenticated user information including the OIDC provider name if the user was authenticated using OIDC.
  • Improved reporting daemon connection and zeromq API version mismatch errors.
    • Silenced daemon connection errors are now repeated in the ZendHQ PHP extension's log file when trying to do a Z-Ray request, Code Tracing request, or monitoring event reporting.
    • Mismatching zeromq API version errors in the daemon's log file now include the offending PHP node's name.

Bug fixes

  • New API and database schema versions
    • ZendHQ daemon extension interface API version is now 20250812.
    • JsonRPC session namespace API version is now 1.12.
    • JsonRPC oauth2 namespace API version is now 1.1.
    • JsonRPC jq namespace API version is now 1.3.