TYPO3 Logo
TYPO3 Core Changelog
Options
Give feedback View source How to edit Edit on GitHub Full documentation (single file)

TYPO3 Core Changelog

  • ChangeLog v14
    • 14.2 Changes
    • 14.1 Changes
    • 14.0 Changes
    • 14.x Changes by type
  • ChangeLog v13
    • 13.4.x Changes
    • 13.4 Changes
    • 13.3 Changes
    • 13.2 Changes
    • 13.1 Changes
    • 13.0 Changes
    • 13.x Changes by type
  • ChangeLog v12
    • 12.4.x Changes
    • 12.4 Changes
    • 12.3 Changes
    • 12.2 Changes
    • 12.1 Changes
    • 12.0 Changes
    • 12.x Changes by type
  • ChangeLog v11
    • 11.5.x Changes
    • 11.5 Changes
    • 11.4 Changes
    • 11.3 Changes
    • 11.2 Changes
    • 11.1 Changes
    • 11.0 Changes
    • 11.x Changes by type
  • ChangeLog v10
    • 10.4.x Changes
    • 10.4 Changes
    • 10.3 Changes
    • 10.2 Changes
    • 10.1 Changes
    • 10.0 Changes
    • 10.x Changes by type
  • ChangeLog v9
    • 9.5.x Changes
    • 9.5 Changes
    • 9.4 Changes
    • 9.3 Changes
    • 9.2 Changes
    • 9.1 Changes
    • 9.0 Changes
    • 9.x Changes by type
  • ChangeLog v8
    • 8.7.x Changes
    • 8.7 Changes
    • 8.6 Changes
    • 8.5 Changes
    • 8.4 Changes
    • 8.3 Changes
    • 8.2 Changes
    • 8.1 Changes
    • 8.0 Changes
    • 8.x Changes by type
  • ChangeLog v7
    • 7.6.x Changes
    • 7.6 Changes
    • 7.5 Changes
    • 7.4 Changes
    • 7.3 Changes
    • 7.2 Changes
    • 7.1 Changes
    • 7.0 Changes
    • 7.x Changes by type
  • Documenting Changes
  • Sitemap
  1. TYPO3 Core Changelog
  2. ChangeLog v14
  3. 14.2 Changes
  4. Feature: #109370 - Array-based queryParameters for Page Links
Give feedback Edit on GitHub

Feature: #109370 - Array-based queryParameters for Page Links 

See forge#109370

Description 

When creating page links programmatically via the LinkFactory PHP API, query parameters previously had to be provided as a URL-encoded string using the additionalParams configuration key. A new queryParameters configuration key has been introduced that accepts a PHP array, including multi-dimensional arrays.

When both queryParameters and additionalParams are set, they are merged using array_replace_recursive(), with queryParameters taking precedence.

Example:

$linkFactory->create('Link text', [
    'parameter' => 42,
    'queryParameters' => [
        'tx_news' => [
            'action' => 'show',
            'id' => 123,
        ],
    ],
], $contentObjectRenderer);
Copied!

The Fluid ViewHelpers <f:link.page>, <f:uri.page>, <f:link.action> and <f:uri.action> now use this option internally to pass their additionalParams argument directly as an array, eliminating a previous serialize/deserialize roundtrip via query string encoding.

Impact 

Developers creating page links via the LinkFactory PHP API can now pass query parameters as structured arrays via the queryParameters configuration key. This avoids manual query string encoding and makes multi-dimensional parameter handling more natural.

The option can be combined with the existing string-based additionalParams. When both are provided, queryParameters values override matching keys from additionalParams.

  • Previous
  • Next
Reference to the headline

Copy and freely share the link

This link target has no permanent anchor assigned. You can make a pull request on GitHub to suggest an anchor. The link below can be used, but is prone to change if the page gets moved.

Copy this link into your TYPO3 manual.

  • Home
  • Contact
  • Issues
  • Repository

Last rendered: Mar 26, 2026 22:17

© since 1997 by the TYPO3 contributors
  • Legal Notice
  • Privacy Policy