@@ -1628,25 +1628,6 @@ crypto_method
1628
1628
The minimum version of TLS to accept. The value must be one of the
1629
1629
``STREAM_CRYPTO_METHOD_TLSv*_CLIENT `` constants defined by PHP.
1630
1630
1631
- .. _reference-http-client-retry-delay :
1632
-
1633
- delay
1634
- .....
1635
-
1636
- **type **: ``integer `` **default **: ``1000 ``
1637
-
1638
- The initial delay in milliseconds used to compute the waiting time between retries.
1639
-
1640
- .. _reference-http-client-retry-enabled :
1641
-
1642
- enabled
1643
- .......
1644
-
1645
- **type **: ``boolean `` **default **: ``false ``
1646
-
1647
- Whether to enable the support for retry failed HTTP request or not.
1648
- This setting is automatically set to true when one of the child settings is configured.
1649
-
1650
1631
extra
1651
1632
.....
1652
1633
@@ -1665,15 +1646,6 @@ headers
1665
1646
An associative array of the HTTP headers added before making the request. This
1666
1647
value must use the format ``['header-name' => 'value0, value1, ...'] ``.
1667
1648
1668
- .. _reference-http-client-retry-http-codes :
1669
-
1670
- http_codes
1671
- ..........
1672
-
1673
- **type **: ``array `` **default **: :method: `Symfony\\ Component\\ HttpClient\\ Retry\\ GenericRetryStrategy::DEFAULT_RETRY_STATUS_CODES `
1674
-
1675
- The list of HTTP status codes that triggers a retry of the request.
1676
-
1677
1649
http_version
1678
1650
............
1679
1651
@@ -1682,18 +1654,6 @@ http_version
1682
1654
The HTTP version to use, typically ``'1.1' `` or ``'2.0' ``. Leave it to ``null ``
1683
1655
to let Symfony select the best version automatically.
1684
1656
1685
- .. _reference-http-client-retry-jitter :
1686
-
1687
- jitter
1688
- ......
1689
-
1690
- **type **: ``float `` **default **: ``0.1 `` (must be between 0.0 and 1.0)
1691
-
1692
- This option adds some randomness to the delay. It's useful to avoid sending
1693
- multiple requests to the server at the exact same time. The randomness is
1694
- calculated as ``delay * jitter ``. For example: if delay is ``1000ms `` and jitter
1695
- is ``0.2 ``, the actual delay will be a number between ``800 `` and ``1200 `` (1000 +/- 20%).
1696
-
1697
1657
local_cert
1698
1658
..........
1699
1659
@@ -1711,16 +1671,6 @@ local_pk
1711
1671
The path of a file that contains the `PEM formatted `_ private key of the
1712
1672
certificate defined in the ``local_cert `` option.
1713
1673
1714
- .. _reference-http-client-retry-max-delay :
1715
-
1716
- max_delay
1717
- .........
1718
-
1719
- **type **: ``integer `` **default **: ``0 ``
1720
-
1721
- The maximum amount of milliseconds initial to wait between retries.
1722
- Use ``0 `` to not limit the duration.
1723
-
1724
1674
max_duration
1725
1675
............
1726
1676
@@ -1749,26 +1699,6 @@ max_redirects
1749
1699
The maximum number of redirects to follow. Use ``0 `` to not follow any
1750
1700
redirection.
1751
1701
1752
- .. _reference-http-client-retry-max-retries :
1753
-
1754
- max_retries
1755
- ...........
1756
-
1757
- **type **: ``integer `` **default **: ``3 ``
1758
-
1759
- The maximum number of retries for failing requests. When the maximum is reached,
1760
- the client returns the last received response.
1761
-
1762
- .. _reference-http-client-retry-multiplier :
1763
-
1764
- multiplier
1765
- ..........
1766
-
1767
- **type **: ``float `` **default **: ``2 ``
1768
-
1769
- This value is multiplied to the delay each time a retry occurs, to distribute
1770
- retries in time instead of making all of them sequentially.
1771
-
1772
1702
no_proxy
1773
1703
........
1774
1704
@@ -1849,11 +1779,13 @@ including which types of requests to retry and how many times. The behavior is
1849
1779
defined with the following options:
1850
1780
1851
1781
* :ref: `delay <reference-http-client-retry-delay >`
1782
+ * :ref: `enabled <reference-http-client-retry-enabled >`
1852
1783
* :ref: `http_codes <reference-http-client-retry-http-codes >`
1853
1784
* :ref: `jitter <reference-http-client-retry-jitter >`
1854
1785
* :ref: `max_delay <reference-http-client-retry-max-delay >`
1855
1786
* :ref: `max_retries <reference-http-client-retry-max-retries >`
1856
1787
* :ref: `multiplier <reference-http-client-retry-multiplier >`
1788
+ * :ref: `retry_strategy <reference-http-client-retry-retry-strategy >`
1857
1789
1858
1790
.. code-block :: yaml
1859
1791
@@ -1881,8 +1813,78 @@ defined with the following options:
1881
1813
retry_failed :
1882
1814
max_retries : 4
1883
1815
1816
+ .. _reference-http-client-retry-delay :
1817
+
1818
+ delay
1819
+ """""
1820
+
1821
+ **type **: ``integer `` **default **: ``1000 ``
1822
+
1823
+ The initial delay in milliseconds used to compute the waiting time between retries.
1824
+
1825
+ .. _reference-http-client-retry-enabled :
1826
+
1827
+ enabled
1828
+ """""""
1829
+
1830
+ **type **: ``boolean `` **default **: ``false ``
1831
+
1832
+ Whether to enable the support for retry failed HTTP request or not.
1833
+ This setting is automatically set to true when one of the child settings is configured.
1834
+
1835
+ .. _reference-http-client-retry-http-codes :
1836
+
1837
+ http_codes
1838
+ """"""""""
1839
+
1840
+ **type **: ``array `` **default **: :method: `Symfony\\ Component\\ HttpClient\\ Retry\\ GenericRetryStrategy::DEFAULT_RETRY_STATUS_CODES `
1841
+
1842
+ The list of HTTP status codes that triggers a retry of the request.
1843
+
1844
+ .. _reference-http-client-retry-jitter :
1845
+
1846
+ jitter
1847
+ """"""
1848
+
1849
+ **type **: ``float `` **default **: ``0.1 `` (must be between 0.0 and 1.0)
1850
+
1851
+ This option adds some randomness to the delay. It's useful to avoid sending
1852
+ multiple requests to the server at the exact same time. The randomness is
1853
+ calculated as ``delay * jitter ``. For example: if delay is ``1000ms `` and jitter
1854
+ is ``0.2 ``, the actual delay will be a number between ``800 `` and ``1200 `` (1000 +/- 20%).
1855
+
1856
+ .. _reference-http-client-retry-max-delay :
1857
+
1858
+ max_delay
1859
+ """""""""
1860
+
1861
+ **type **: ``integer `` **default **: ``0 ``
1862
+
1863
+ The maximum amount of milliseconds initial to wait between retries.
1864
+ Use ``0 `` to not limit the duration.
1865
+
1866
+ .. _reference-http-client-retry-max-retries :
1867
+
1868
+ max_retries
1869
+ """""""""""
1870
+
1871
+ **type **: ``integer `` **default **: ``3 ``
1872
+
1873
+ The maximum number of retries for failing requests. When the maximum is reached,
1874
+ the client returns the last received response.
1875
+
1876
+ .. _reference-http-client-retry-multiplier :
1877
+
1878
+ multiplier
1879
+ """"""""""
1880
+
1881
+ **type **: ``float `` **default **: ``2 ``
1882
+
1883
+ This value is multiplied to the delay each time a retry occurs, to distribute
1884
+ retries in time instead of making all of them sequentially.
1885
+
1884
1886
retry_strategy
1885
- ..............
1887
+ """"""""""""""
1886
1888
1887
1889
**type **: ``string ``
1888
1890
0 commit comments