diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml index 3722546330d..42770d55fe3 100644 --- a/.github/workflows/ci.yaml +++ b/.github/workflows/ci.yaml @@ -72,7 +72,7 @@ jobs: key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }} - name: "Run DOCtor-RST" - uses: docker://oskarstark/doctor-rst:1.69.1 + uses: docker://oskarstark/doctor-rst:1.70.0 with: args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache diff --git a/http_client.rst b/http_client.rst index 7b1d403a83d..bdb51681dc3 100644 --- a/http_client.rst +++ b/http_client.rst @@ -175,8 +175,9 @@ Some options are described in this guide: Check out the full :ref:`http_client config reference ` to learn about all the options. -The HTTP client also has one configuration option called -``max_host_connections``, this option can not be overridden by a request: +The HTTP client also has a configuration option called +:ref:`max_host_connections `. +This option cannot be overridden per request: .. configuration-block:: @@ -1343,6 +1344,9 @@ code waits only when necessary. or access to certificate files). To avoid hitting these limits, consider processing requests in batches. + There is, however, a maximum amount of concurrent connections that can be open + per host (``6`` by default). See :ref:`max_host_connections `. + Multiplexing Responses ~~~~~~~~~~~~~~~~~~~~~~ diff --git a/messenger.rst b/messenger.rst index 46ee188d68d..18fc5e03cec 100644 --- a/messenger.rst +++ b/messenger.rst @@ -2356,7 +2356,7 @@ will take care of creating a new process with the parameters you passed:: } If you want to use shell features such as redirections or pipes, use the static -factory :method:Symfony\\Component\\Process\\Messenger\\RunProcessMessage::fromShellCommandline:: +:method:`Symfony\\Component\\Process\\Messenger\\RunProcessMessage::fromShellCommandline` factory method:: use Symfony\Component\Messenger\MessageBusInterface; use Symfony\Component\Process\Messenger\RunProcessMessage; diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst index 38bb2ac9c45..2aa716ae9fc 100644 --- a/reference/configuration/doctrine.rst +++ b/reference/configuration/doctrine.rst @@ -159,22 +159,22 @@ If you want to configure multiple connections in YAML, put them under the .. code-block:: yaml - doctrine: - dbal: - default_connection: default - connections: - default: - dbname: Symfony - user: root - password: null - host: localhost - server_version: '8.0.37' - customer: - dbname: customer - user: root - password: null - host: localhost - server_version: '8.2.0' + doctrine: + dbal: + default_connection: default + connections: + default: + dbname: Symfony + user: root + password: null + host: localhost + server_version: '8.0.37' + customer: + dbname: customer + user: root + password: null + host: localhost + server_version: '8.2.0' .. code-block:: php @@ -231,18 +231,18 @@ that the ORM resolves to: .. code-block:: yaml - doctrine: - orm: - auto_mapping: false - # the standard distribution overrides this to be true in debug, false otherwise - auto_generate_proxy_classes: false - proxy_namespace: Proxies - proxy_dir: '%kernel.cache_dir%/doctrine/orm/Proxies' - default_entity_manager: default - metadata_cache_driver: array - query_cache_driver: array - result_cache_driver: array - naming_strategy: doctrine.orm.naming_strategy.default + doctrine: + orm: + auto_mapping: false + # the standard distribution overrides this to be true in debug, false otherwise + auto_generate_proxy_classes: false + proxy_namespace: Proxies + proxy_dir: '%kernel.cache_dir%/doctrine/orm/Proxies' + default_entity_manager: default + metadata_cache_driver: array + query_cache_driver: array + result_cache_driver: array + naming_strategy: doctrine.orm.naming_strategy.default .. code-block:: php diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst index 3aae95f1814..ff900b132e1 100644 --- a/reference/configuration/framework.rst +++ b/reference/configuration/framework.rst @@ -1740,6 +1740,8 @@ max_duration The maximum execution time, in seconds, that the request and the response are allowed to take. A value lower than or equal to 0 means it is unlimited. +.. _reference-http-client-max-host-connections: + max_host_connections .................... diff --git a/reference/constraints/Url.rst b/reference/constraints/Url.rst index fbeaa6da522..c3fac520f96 100644 --- a/reference/constraints/Url.rst +++ b/reference/constraints/Url.rst @@ -323,7 +323,7 @@ also relative URLs that contain no protocol (e.g. ``//example.com``). and will default to ``true`` in Symfony 8.0. By default, URLs like ``https://aaa`` or ``https://foobar`` are considered valid -because they are tecnically correct according to the `URL spec`_. If you set this option +because they are technically correct according to the `URL spec`_. If you set this option to ``true``, the host part of the URL will have to include a TLD (top-level domain name): e.g. ``https://example.com`` will be valid but ``https://example`` won't. diff --git a/service_container/factories.rst b/service_container/factories.rst index 0c6a4724609..9864287d57a 100644 --- a/service_container/factories.rst +++ b/service_container/factories.rst @@ -389,7 +389,7 @@ e.g. change the service based on a parameter: # you can use the arg() function to retrieve an argument from the definition App\Email\NewsletterManagerInterface: - factory: "@=arg(0).createNewsletterManager() ?: service("default_newsletter_manager")" + factory: '@=arg(0).createNewsletterManager() ?: service("default_newsletter_manager")' arguments: - '@App\Email\NewsletterManagerFactory' @@ -410,7 +410,7 @@ e.g. change the service based on a parameter: - + diff --git a/templates.rst b/templates.rst index 151ac5f71be..e895b4a6df3 100644 --- a/templates.rst +++ b/templates.rst @@ -304,10 +304,10 @@ You can now use the ``asset()`` function: .. code-block:: html+twig {# the image lives at "public/images/logo.png" #} - Symfony! + Symfony! {# the CSS file lives at "public/css/blog.css" #} - + {# the JS file lives at "public/bundles/acme/js/loader.js" #} @@ -332,7 +332,7 @@ as follows: .. code-block:: html+twig - Symfony! + Symfony! @@ -973,7 +973,7 @@ following code to display the user information is repeated in several places: {# ... #} @@ -1258,7 +1258,7 @@ In practice, the ``base.html.twig`` template would look like this: {% block title %}My Application{% endblock %} {% block stylesheets %} - + {% endblock %} diff --git a/webhook.rst b/webhook.rst index 6e9408c12eb..d27a6e6d906 100644 --- a/webhook.rst +++ b/webhook.rst @@ -117,7 +117,7 @@ webhook consumer code. The webhook routing name is part of the URL you need to configure at the third-party mailer provider. The URL is the concatenation of your domain name and the routing name you chose in the configuration (like -``https://example.com/webhook/mailer_mailgun``. +``https://example.com/webhook/mailer_mailgun``). For Mailgun, you will get a secret for the webhook. Store this secret as MAILER_MAILGUN_SECRET (in the :doc:`secrets management system