mirror of
https://github.com/symfony/symfony-docs.git
synced 2026-03-24 00:32:14 +01:00
Merge branch '6.4' into 7.0
* 6.4: Minor: remove duplicated lines
This commit is contained in:
@@ -467,7 +467,6 @@ and use that when configuring the pool.
|
||||
->adapters(['cache.adapter.redis'])
|
||||
->provider('app.my_custom_redis_provider');
|
||||
|
||||
|
||||
$container->register('app.my_custom_redis_provider', \Redis::class)
|
||||
->setFactory([RedisAdapter::class, 'createConnection'])
|
||||
->addArgument('redis://localhost')
|
||||
|
||||
@@ -135,7 +135,6 @@ The following cache adapters are available:
|
||||
|
||||
cache/adapters/*
|
||||
|
||||
|
||||
.. _cache-component-psr6-caching:
|
||||
|
||||
Generic Caching (PSR-6)
|
||||
|
||||
@@ -35,7 +35,6 @@ the second and third parameters::
|
||||
$defaultLifetime
|
||||
);
|
||||
|
||||
|
||||
Configure the Connection
|
||||
------------------------
|
||||
|
||||
@@ -67,7 +66,6 @@ helper method allows creating and configuring a `Couchbase Bucket`_ class instan
|
||||
'couchbase:?host[localhost]&host[localhost:12345]'
|
||||
);
|
||||
|
||||
|
||||
Configure the Options
|
||||
---------------------
|
||||
|
||||
|
||||
@@ -32,7 +32,6 @@ the second and third parameters::
|
||||
$defaultLifetime
|
||||
);
|
||||
|
||||
|
||||
Configure the Connection
|
||||
------------------------
|
||||
|
||||
@@ -64,7 +63,6 @@ helper method allows creating and configuring a `Couchbase Collection`_ class in
|
||||
'couchbase:?host[localhost]&host[localhost:12345]'
|
||||
);
|
||||
|
||||
|
||||
Configure the Options
|
||||
---------------------
|
||||
|
||||
|
||||
@@ -63,6 +63,5 @@ adapter offers better read performance when using tag-based invalidation::
|
||||
|
||||
$cache = new FilesystemTagAwareAdapter();
|
||||
|
||||
|
||||
.. _`tmpfs`: https://wiki.archlinux.org/index.php/tmpfs
|
||||
.. _`RAM disk solutions`: https://en.wikipedia.org/wiki/List_of_RAM_drive_software
|
||||
|
||||
1
components/cache/cache_pools.rst
vendored
1
components/cache/cache_pools.rst
vendored
@@ -25,7 +25,6 @@ ready to use in your applications.
|
||||
|
||||
adapters/*
|
||||
|
||||
|
||||
Using the Cache Contracts
|
||||
-------------------------
|
||||
|
||||
|
||||
@@ -99,4 +99,3 @@ Filtering data::
|
||||
$event['data'] = strtolower($event['data']);
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@@ -26,7 +26,6 @@ The Workflow of a Request
|
||||
:doc:`/event_dispatcher` articles to learn about how to use it to create
|
||||
controllers and define events in Symfony applications.
|
||||
|
||||
|
||||
Every HTTP web interaction begins with a request and ends with a response.
|
||||
Your job as a developer is to create PHP code that reads the request information
|
||||
(e.g. the URL) and creates and returns a response (e.g. an HTML page or JSON string).
|
||||
|
||||
@@ -10,7 +10,6 @@ Installation
|
||||
|
||||
$ composer require symfony/process
|
||||
|
||||
|
||||
.. include:: /components/require_autoload.rst.inc
|
||||
|
||||
Usage
|
||||
|
||||
@@ -337,7 +337,6 @@ configuration file using a special syntax: wrap the parameter name in two ``%``
|
||||
]);
|
||||
};
|
||||
|
||||
|
||||
.. note::
|
||||
|
||||
If some parameter value includes the ``%`` character, you need to escape it
|
||||
|
||||
@@ -74,7 +74,6 @@ Web front-controller::
|
||||
require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
|
||||
// ...
|
||||
|
||||
|
||||
.. _override-config-dir:
|
||||
|
||||
Override the Configuration Directory
|
||||
|
||||
@@ -538,7 +538,6 @@ call ``setAutoExit(false)`` on it to get the command result in ``CommandTester``
|
||||
|
||||
$tester = new ApplicationTester($application);
|
||||
|
||||
|
||||
.. caution::
|
||||
|
||||
When testing ``InputOption::VALUE_NONE`` command options, you must pass an
|
||||
|
||||
@@ -149,7 +149,6 @@ you don't have to use "Please" all the time. But it wouldn't hurt.
|
||||
It may not seem like much, but saying "Thank you" does make others feel
|
||||
more welcome.
|
||||
|
||||
|
||||
Preventing Escalations
|
||||
----------------------
|
||||
|
||||
|
||||
@@ -175,7 +175,6 @@ Images and Diagrams
|
||||
alt="Some concise description."
|
||||
></object>
|
||||
|
||||
|
||||
English Language Standards
|
||||
--------------------------
|
||||
|
||||
|
||||
@@ -605,7 +605,6 @@ that behavior, use the `orphanRemoval`_ option inside ``Category``:
|
||||
#[ORM\OneToMany(targetEntity: Product::class, mappedBy: 'category', orphanRemoval: true)]
|
||||
private array $products;
|
||||
|
||||
|
||||
Thanks to this, if the ``Product`` is removed from the ``Category``, it will be
|
||||
removed from the database entirely.
|
||||
|
||||
|
||||
@@ -465,7 +465,6 @@ Symfony passes a series of variables to the template used to render the form
|
||||
type. You can also pass your own variables, which can be based on the options
|
||||
defined by the form or be completely independent::
|
||||
|
||||
|
||||
// src/Form/Type/PostalAddressType.php
|
||||
namespace App\Form\Type;
|
||||
|
||||
|
||||
@@ -573,7 +573,6 @@ Now, you need to put some code into the ``removeTag()`` method of ``Task``::
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
The ``allow_delete`` option means that if an item of a collection
|
||||
isn't sent on submission, the related data is removed from the collection
|
||||
on the server. In order for this to work in an HTML form, you must remove
|
||||
|
||||
@@ -141,7 +141,6 @@ After creating the strategy PHP class, register it as a Symfony service.
|
||||
);
|
||||
};
|
||||
|
||||
|
||||
Finally, enable the new asset versioning for all the application assets or just
|
||||
for some :ref:`asset package <reference-framework-assets-packages>` thanks to
|
||||
the :ref:`version_strategy <reference-assets-version-strategy>` option:
|
||||
|
||||
@@ -122,7 +122,6 @@ Live Reloading when changing PHP / Twig Files
|
||||
To utilize the HMR superpower along with live reload for your PHP code and
|
||||
templates, set the following options:
|
||||
|
||||
|
||||
.. code-block:: javascript
|
||||
|
||||
// webpack.config.js
|
||||
|
||||
@@ -9,7 +9,7 @@ Enabling React.js with Webpack Encore
|
||||
.. tip::
|
||||
|
||||
Check out live demos of Symfony UX React component at `https://ux.symfony.com/react`_!
|
||||
|
||||
|
||||
Using React? First add some dependencies with npm:
|
||||
|
||||
.. code-block:: terminal
|
||||
@@ -28,7 +28,6 @@ Enable react in your ``webpack.config.js``:
|
||||
+ .enableReactPreset()
|
||||
;
|
||||
|
||||
|
||||
Then restart Encore. When you do, it will give you a command you can run to
|
||||
install any missing dependencies. After running that command and restarting
|
||||
Encore, you're done!
|
||||
|
||||
@@ -22,7 +22,6 @@ To enable this, call ``splitEntryChunks()``:
|
||||
|
||||
+ .splitEntryChunks()
|
||||
|
||||
|
||||
Now, each output file (e.g. ``homepage.js``) *may* be split into multiple file
|
||||
(e.g. ``homepage.js`` & ``vendors-node_modules_jquery_dist_jquery_js.js`` - the
|
||||
filename of the second will be less obvious when you build for production). This
|
||||
|
||||
@@ -501,14 +501,12 @@ And here is the controller::
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
.. tip::
|
||||
|
||||
You cannot use the ``mercure()`` helper and the ``setCookie()``
|
||||
method at the same time (it would set the cookie twice on a single request). Choose
|
||||
either one method or the other.
|
||||
|
||||
|
||||
Programmatically Generating The JWT Used to Publish
|
||||
---------------------------------------------------
|
||||
|
||||
|
||||
@@ -2681,7 +2681,6 @@ and a different instance will be created per bus.
|
||||
- 'App\Middleware\MyMiddleware'
|
||||
- 'App\Middleware\AnotherMiddleware'
|
||||
|
||||
|
||||
.. code-block:: xml
|
||||
|
||||
<!-- config/packages/messenger.xml -->
|
||||
|
||||
@@ -222,7 +222,6 @@ production. To do that, create an :doc:`event subscriber </event_dispatcher>`
|
||||
and listen to the :ref:`kernel.response <component-http-kernel-kernel-response>`
|
||||
event::
|
||||
|
||||
|
||||
use Symfony\Component\EventDispatcher\EventSubscriberInterface;
|
||||
use Symfony\Component\HttpKernel\Event\ResponseEvent;
|
||||
use Symfony\Component\HttpKernel\KernelInterface;
|
||||
|
||||
@@ -2847,6 +2847,30 @@ annotation changes). For performance reasons, it is recommended to disable
|
||||
debug mode in production, which will happen automatically if you use the
|
||||
default value.
|
||||
|
||||
secrets
|
||||
~~~~~~~
|
||||
|
||||
decryption_env_var
|
||||
..................
|
||||
|
||||
**type**: ``string`` **default**: ``base64:default::SYMFONY_DECRYPTION_SECRET``
|
||||
|
||||
The environment variable that contains the decryption key.
|
||||
|
||||
local_dotenv_file
|
||||
.................
|
||||
|
||||
**type**: ``string`` **default**: ``%kernel.project_dir%/.env.%kernel.environment%.local``
|
||||
|
||||
Path to an dotenv file that holds secrets. This is primarily used for testing.
|
||||
|
||||
vault_directory
|
||||
...............
|
||||
|
||||
**type**: ``string`` **default**: ``%kernel.project_dir%/config/secrets/%kernel.environment%``
|
||||
|
||||
The directory where the vault of secrets is stored.
|
||||
|
||||
.. _configuration-framework-serializer:
|
||||
|
||||
serializer
|
||||
|
||||
@@ -103,4 +103,3 @@ Parameter Description
|
||||
|
||||
.. _`ISO 3166-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes
|
||||
.. _`ISO 3166-1 alpha-3`: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3#Current_codes
|
||||
|
||||
|
||||
@@ -10,7 +10,6 @@ To force that a value is *not* equal, see :doc:`/reference/constraints/NotEqualT
|
||||
equal. Use :doc:`/reference/constraints/IdenticalTo` to compare with
|
||||
``===``.
|
||||
|
||||
|
||||
========== ===================================================================
|
||||
Applies to :ref:`property or method <validation-property-target>`
|
||||
Class :class:`Symfony\\Component\\Validator\\Constraints\\EqualTo`
|
||||
|
||||
@@ -35,7 +35,6 @@ and ``50``, you might add the following:
|
||||
protected string $firstName;
|
||||
}
|
||||
|
||||
|
||||
.. code-block:: yaml
|
||||
|
||||
# config/validator/validation.yaml
|
||||
|
||||
@@ -63,7 +63,6 @@ positive number (greater than zero):
|
||||
use Symfony\Component\Validator\Constraints as Assert;
|
||||
use Symfony\Component\Validator\Mapping\ClassMetadata;
|
||||
|
||||
|
||||
class Employee
|
||||
{
|
||||
// ...
|
||||
|
||||
@@ -95,5 +95,4 @@ Parameter Description
|
||||
|
||||
.. include:: /reference/constraints/_payload-option.rst.inc
|
||||
|
||||
|
||||
.. _`Universally Unique Lexicographically Sortable Identifier (ULID)`: https://github.com/ulid/spec
|
||||
|
||||
@@ -63,7 +63,6 @@ The basic usage of the MessageFormat allows you to use placeholders (called
|
||||
'say_hello' => "Hello {name}!",
|
||||
];
|
||||
|
||||
|
||||
.. caution::
|
||||
|
||||
In the previous translation format, placeholders were often wrapped in ``%``
|
||||
|
||||
@@ -1815,7 +1815,6 @@ host name:
|
||||
;
|
||||
};
|
||||
|
||||
|
||||
The value of the ``host`` option can include parameters (which is useful in
|
||||
multi-tenant applications) and these parameters can be validated too with
|
||||
``requirements``:
|
||||
|
||||
@@ -281,7 +281,6 @@ The following credential classes are supported by default:
|
||||
$apiToken
|
||||
));
|
||||
|
||||
|
||||
Self Validating Passport
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
|
||||
@@ -67,7 +67,6 @@ You can configure this using the ``entry_point`` setting:
|
||||
$security->enableAuthenticatorManager(true);
|
||||
// ....
|
||||
|
||||
|
||||
// allow authentication using a form or HTTP basic
|
||||
$mainFirewall = $security->firewall('main');
|
||||
$mainFirewall
|
||||
|
||||
@@ -197,7 +197,6 @@ use the ``ldap`` user provider.
|
||||
;
|
||||
};
|
||||
|
||||
|
||||
.. caution::
|
||||
|
||||
The Security component escapes provided input data when the LDAP user
|
||||
@@ -530,4 +529,3 @@ Configuration example for form login and query_string
|
||||
.. _`LDAP PHP extension`: https://www.php.net/manual/en/intro.ldap.php
|
||||
.. _`RFC4515`: https://datatracker.ietf.org/doc/rfc4515/
|
||||
.. _`LDAP injection`: http://projects.webappsec.org/w/page/13246947/LDAP%20Injection
|
||||
|
||||
|
||||
@@ -46,7 +46,6 @@ create your own encoder that uses the
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
Registering it in your app
|
||||
--------------------------
|
||||
|
||||
|
||||
@@ -43,7 +43,6 @@ service's class or interface name. Want to :doc:`log </logging>` something? No p
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
What other services are available? Find out by running:
|
||||
|
||||
.. code-block:: terminal
|
||||
@@ -502,7 +501,6 @@ pass here. No problem! In your configuration, you can explicitly set this argume
|
||||
;
|
||||
};
|
||||
|
||||
|
||||
Thanks to this, the container will pass ``manager@example.com`` to the ``$adminEmail``
|
||||
argument of ``__construct`` when creating the ``SiteUpdateManager`` service. The
|
||||
other arguments will still be autowired.
|
||||
|
||||
@@ -117,7 +117,6 @@ both services:
|
||||
->autowire();
|
||||
};
|
||||
|
||||
|
||||
Now, you can use the ``TwitterClient`` service immediately in a controller::
|
||||
|
||||
// src/Controller/DefaultController.php
|
||||
@@ -252,7 +251,6 @@ adding a service alias:
|
||||
$services->alias(Rot13Transformer::class, 'app.rot13.transformer');
|
||||
};
|
||||
|
||||
|
||||
This creates a service "alias", whose id is ``App\Util\Rot13Transformer``.
|
||||
Thanks to this, autowiring sees this and uses it whenever the ``Rot13Transformer``
|
||||
class is type-hinted.
|
||||
@@ -357,7 +355,6 @@ To fix that, add an :ref:`alias <service-autowiring-alias>`:
|
||||
$services->alias(TransformerInterface::class, Rot13Transformer::class);
|
||||
};
|
||||
|
||||
|
||||
Thanks to the ``App\Util\TransformerInterface`` alias, the autowiring subsystem
|
||||
knows that the ``App\Util\Rot13Transformer`` service should be injected when
|
||||
dealing with the ``TransformerInterface``.
|
||||
|
||||
@@ -82,7 +82,6 @@ create its object:
|
||||
->factory([NewsletterManagerStaticFactory::class, 'createNewsletterManager']);
|
||||
};
|
||||
|
||||
|
||||
.. note::
|
||||
|
||||
When using a factory to create services, the value chosen for class
|
||||
|
||||
@@ -367,7 +367,6 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
|
||||
->args([service('.inner')]);
|
||||
};
|
||||
|
||||
|
||||
The generated code will be the following::
|
||||
|
||||
$this->services[Foo::class] = new Baz(new Bar(new Foo()));
|
||||
|
||||
@@ -71,7 +71,6 @@ configuration:
|
||||
->synthetic();
|
||||
};
|
||||
|
||||
|
||||
Now, you can inject the instance in the container using
|
||||
:method:`Container::set() <Symfony\\Component\\DependencyInjection\\Container::set>`::
|
||||
|
||||
|
||||
@@ -44,7 +44,6 @@ example:
|
||||
->tag('twig.extension');
|
||||
};
|
||||
|
||||
|
||||
Services tagged with the ``twig.extension`` tag are collected during the
|
||||
initialization of TwigBundle and added to Twig as extensions.
|
||||
|
||||
@@ -327,7 +326,6 @@ Then, define the chain as a service:
|
||||
$services->set(TransportChain::class);
|
||||
};
|
||||
|
||||
|
||||
Define Services with a Custom Tag
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
|
||||
@@ -997,7 +997,6 @@ the MongoDB connection as argument, and the required parameters:
|
||||
``collection``:
|
||||
The name of the collection
|
||||
|
||||
|
||||
.. configuration-block::
|
||||
|
||||
.. code-block:: yaml
|
||||
|
||||
@@ -228,7 +228,6 @@ computer, and execute the following command:
|
||||
|
||||
Replace ``[token]`` with the value of your Gitlab personal access token.
|
||||
|
||||
|
||||
Configure Your Project's ``composer.json`` File
|
||||
-----------------------------------------------
|
||||
|
||||
@@ -308,4 +307,3 @@ install the new private recipes, run the following command:
|
||||
|
||||
.. _`release of version 1.16`: https://github.com/symfony/cli
|
||||
.. _`Symfony recipe files`: https://github.com/symfony/recipes/tree/flex/main
|
||||
|
||||
|
||||
@@ -197,7 +197,6 @@ When using Caddy on the server, you can use a configuration like this:
|
||||
encode zstd gzip
|
||||
file_server
|
||||
|
||||
|
||||
# otherwise, use PHP-FPM (replace "unix//var/..." with "127.0.0.1:9000" when using TCP)
|
||||
php_fastcgi unix//var/run/php/php7.4-fpm.sock {
|
||||
# optionally set the value of the environment variables used in the application
|
||||
|
||||
@@ -545,4 +545,3 @@ class to simplify writing unit tests for your custom constraints::
|
||||
// ...
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user