Miscellaneous script services reference

services.request (Shopware\Core\Framework\Routing\Facade\RequestFacade)

The request service allows you to access the current request in the script Examples:

{% block response %}
 {% if services.request.method != "POST" %}
     {% set response = services.response.json({
         'error': 'Only POST requests are allowed',
     }, 405) %}
     {% do hook.setResponse(response) %}
     {% return %}
 {% endif %}

 {% set response = services.response.json(services.request.request) %}
 {% do hook.setResponse(response) %}
{% endblock %}

ip()

• The ip method returns the real client ip address

• Returns string | null

  request client ip address

scheme()

• The scheme method returns the request scheme

• Returns string

  request scheme

method()

• The method returns the request method in upper case

• Returns string

  request method in upper case

uri()

• The method uri returns the request uri with the resolved url

• Returns string

  request uri

pathInfo()

• The method pathInfo returns the request path info. The path info can be also an internal link when a seo url is used.

• Returns string

  request path info

query()

• The method query returns all query parameters as an array

• Returns array

  request query parameters

request()

• The method request returns all post parameters as an array.

  On application/json requests this contains also the json body parsed as an array.

• Returns array

  request post parameters

headers()

• The method headers returns all request headers as an array.

  It is possible to access only the following headers: content-type, content-length, accept, accept-language, user-agent, referer

• Returns array

  request headers

cookies()

• The method cookies returns all request cookies as an array.

• Returns array

  request cookies

---

Shopware\Core\Framework\Script\Facade\ArrayFacade

The ArrayFacade acts as a wrapper around an array and allows easier manipulation of arrays inside scripts. An array facade can also be accessed like a "normal" array inside twig. Examples:

{% do array.push('test') %}

{% do array.foo = 'bar' }

{% do array.has('foo') }

{% if array.foo === 'bar' %}

{% foreach array as key => value %}

set()

• set() adds a new element to the array using the given key.

• Arguments:

  • string|int key: The array key.
  • mixed value: The value that should be added.

• Examples:

  • Add a new element with key test and value 1.

    {% set product = services.cart.products.get(hook.ids.get('p1')) %}
    
    {% do product.payload.set('test', 1) %}

push()

• push() adds a new value to the end of the array.

• Arguments:

  • mixed value: The value that should be added.

removeBy()

• removeBy() removes the value at the given index from the array.

• Arguments:

  • string|int index: The index that should be removed.

remove()

• remove() removes the given value from the array. It does nothing if the provided value does not exist in the array.

• Arguments:

  • mixed value: The value that should be removed.

reset()

• reset() removes all entries from the array.

merge()

• merge() recursively merges the array with the given array.

• Arguments:

  • array<string|int,mixed>|\ArrayFacade array: The array that should be merged with this array. Either a plain array or another ArrayFacade.

• Examples:

  • Merge two arrays.

    {% set my_array = array({'bar': 'foo', 'baz': true}) %}
    
    {% do product.payload.merge(my_array) %}

replace()

• replace() recursively replaces elements from the given array into this array.

• Arguments:

  • array<string|int,mixed>|\ArrayFacade array: The array from which the elements should be replaced into this array. Either a plain array or another ArrayFacade.

• Examples:

  • Replace elements in the product payload array.

    {% set second = array({'bar': 'baz'}) %}
    
    {% do product.payload.replace(second) %}

count()

• count() returns the count of elements inside this array.

• Returns int

  Returns the count of elements.

all()

• all() function returns all elements of this array.

• Returns array

  Returns all elements of this array.

---

services.config (Shopware\Core\System\SystemConfig\Facade\SystemConfigFacade)

The config service allows you to access the shop's and your app's configuration values.

get()

• The get() method allows you to access all config values of the store.

  Notice that your app needs the system_config:read privilege to use this method.

• Returns array|bool|float|int|string|null

• Arguments:

  • string key: The key of the configuration value e.g. core.listing.defaultSorting.

  • string | null salesChannelId: The SalesChannelId if you need the config value for a specific SalesChannel, if you don't provide a SalesChannelId, the one of the current Context is used as default.

    Default: null

• Examples:

  • Read an arbitrary system_config value.

    {% set systemConfig = services.config.get('core.listing.productsPerPage') %}

app()

• The app() method allows you to access the config values your app's configuration.

  Notice that your app does not need any additional privileges to use this method, as you can only access your own app's configuration.

• Returns array|bool|float|int|string|null

• Arguments:

  • string key: The name of the configuration value specified in the config.xml e.g. exampleTextField.

  • string | null salesChannelId: The SalesChannelId if you need the config value for a specific SalesChannel, if you don't provide a SalesChannelId, the one of the current Context is used as default.

    Default: null

• Examples:

  • Read your app's config value.

    {% set appConfig = services.config.app('app_config') %}

---