Jul 4, 2025 · Jul 23, 2025 · Jul 7, 2025 · Jul 23, 2025
diff --git a/security/passwords.rst b/security/passwords.rst
        security:
            # ...
            password_hashers:
 app_hasher:
 App\Entity\User:
                    id: 'App\Security\Hasher\MyCustomPasswordHasher'

    .. code-block:: xml

            <config>
                <!-- ... -->
                <security:password_hasher class="app_hasher"
                <security:password_hasher class="App\Entity\User"
                    id="App\Security\Hasher\MyCustomPasswordHasher"/>
            </config>
        </srv:container>

        return static function (SecurityConfig $security): void {
            // ...
            $security->passwordHasher('app_hasher')
            $security->passwordHasher('App\Entity\User')
                ->id(MyCustomPasswordHasher::class)
            ;
        };

 This creates a hasher named ``app_hasher`` from a service with the ID
 This creates a hasher named ``App\Entity\User`` from a service with the ID
 ``App\Security\Hasher\MyCustomPasswordHasher``.

 Hashing a Stand-Alone String
        security:
            # ...
            password_hashers:
 app_hasher:
 App\Entity\User:
                    # the service ID of your custom hasher (the FQCN using the default services.yaml)
                    id: 'App\Security\Hasher\MyCustomPasswordHasher'

            <config>
                <!-- ... -->
                <!-- id: the service ID of your custom hasher (the FQCN using the default services.yaml) -->
                <security:password_hasher class="app_hasher"
                <security:password_hasher class="App\Entity\User"
                    id="App\Security\Hasher\CustomVerySecureHasher"/>
            </config>
        </srv:container>

        return static function (SecurityConfig $security): void {
            // ...
            $security->passwordHasher('app_hasher')
            $security->passwordHasher('App\Entity\User')
                // the service ID of your custom hasher (the FQCN using the default services.yaml)
                ->id(CustomVerySecureHasher::class)
            ;
Original file line number	Diff line number	Diff line change
Expand Up		@@ -626,7 +626,7 @@ you must register a service for it in order to use it as a named hasher:
		security:
		# ...
		password_hashers:
		app_hasher:
		App\Entity\User:
Copy link Member javiereguiluzJul 7, 2025 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. We'd need to also update the XML and PHP examples. And, at the end of this section we have this, that should also be updated: This creates a hasher named`app_hasher` from a service [...] Copy link ContributorAuthor andreyboloninJul 23, 2025 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. fixed
		id: 'App\Security\Hasher\MyCustomPasswordHasher'

		.. code-block:: xml
Expand All		@@ -644,7 +644,7 @@ you must register a service for it in order to use it as a named hasher:

		<config>
		<!-- ... -->
		<security:password_hasher class="app_hasher"
		<security:password_hasher class="App\Entity\User"
		id="App\Security\Hasher\MyCustomPasswordHasher"/>
		</config>
		</srv:container>
Expand All		@@ -657,12 +657,12 @@ you must register a service for it in order to use it as a named hasher:

		return static function (SecurityConfig $security): void {
		// ...
		$security->passwordHasher('app_hasher')
		$security->passwordHasher('App\Entity\User')
		->id(MyCustomPasswordHasher::class)
		;
		};

		This creates a hasher named ``app_hasher`` from a service with the ID
		This creates a hasher named ``App\Entity\User`` from a service with the ID
		``App\Security\Hasher\MyCustomPasswordHasher``.

		Hashing a Stand-Alone String
Expand DownExpand Up		@@ -842,7 +842,7 @@ Now, define a password hasher using the ``id`` setting:
		security:
		# ...
		password_hashers:
		app_hasher:
		App\Entity\User:
		# the service ID of your custom hasher (the FQCN using the default services.yaml)
		id: 'App\Security\Hasher\MyCustomPasswordHasher'

Expand All		@@ -862,7 +862,7 @@ Now, define a password hasher using the ``id`` setting:
		<config>
		<!-- ... -->
		<!-- id: the service ID of your custom hasher (the FQCN using the default services.yaml) -->
		<security:password_hasher class="app_hasher"
		<security:password_hasher class="App\Entity\User"
		id="App\Security\Hasher\CustomVerySecureHasher"/>
		</config>
		</srv:container>
Expand All		@@ -875,7 +875,7 @@ Now, define a password hasher using the ``id`` setting:

		return static function (SecurityConfig $security): void {
		// ...
		$security->passwordHasher('app_hasher')
		$security->passwordHasher('App\Entity\User')
		// the service ID of your custom hasher (the FQCN using the default services.yaml)
		->id(CustomVerySecureHasher::class)
		;
Expand Down