minor #13791 Update the Snippet with the PasswordUpgraderInterface (zairigimad)

This PR was submitted for the 5.0 branch but it was merged into the 4.4 branch instead.

Discussion
----------

Update the Snippet with the PasswordUpgraderInterface

<!--

If your pull request fixes a BUG, use the oldest maintained branch that contains
the bug (see https://symfony.com/releases for the list of maintained branches).

If your pull request documents a NEW FEATURE, use the same Symfony branch where
the feature was introduced (and `master` for features of unreleased versions).

-->

Commits
-------

864cefb Update the Snippet with the UserUpgraderInterface

Author: wouterj

security/user_provider.rst

@@ -356,10 +356,11 @@ command will generate a nice skeleton to get you started::
 
     use Symfony\Component\Security\Core\Exception\UnsupportedUserException;
     use Symfony\Component\Security\Core\Exception\UsernameNotFoundException;
+    use Symfony\Component\Security\Core\User\PasswordUpgraderInterface;
     use Symfony\Component\Security\Core\User\UserInterface;
     use Symfony\Component\Security\Core\User\UserProviderInterface;
 
-    class UserProvider implements UserProviderInterface
+    class UserProvider implements UserProviderInterface, PasswordUpgraderInterface
     {
         /**
          * Symfony calls this method if you use features like switch_user
@@ -412,6 +413,16 @@ command will generate a nice skeleton to get you started::
         {
             return User::class === $class || is_subclass_of($class, User::class);
         }
+        
+        /**
+         * Upgrades the encoded password of a user, typically for using a better hash algorithm.
+         */
+        public function upgradePassword(UserInterface $user, string $newEncodedPassword): void
+        {
+            // TODO: when encoded passwords are in use, this method should:
+            // 1. persist the new password in the user storage
+            // 2. update the $user object with $user->setPassword($newEncodedPassword);
+        }
     }
 
 Most of the work is already done! Read the comments in the code and update the