laravel密码重置 功能开箱即用,只需配置 User 模型、运行迁移、配置邮件、注册 Auth路由 并可选自定义视图;核心是确保 数据库、邮件、路由与视图四环节协同工作。

Laravel 自带的 密码重置 功能开箱即用,只需少量配置和几条 Artisan 命令就能跑通完整流程:用户点击“忘记密码”→ 填写 邮箱 → 收到含一次性重置链接的邮件 → 点击链接跳转到新密码表单 → 提交完成重置。关键在于理解各组件如何协作,而不是从零手写逻辑。
启用内置密码重置(基础配置)
确保你的 User 模型实现了 IlluminateContractsAuthCanResetPassword 接口(Laravel 默认已实现)。检查 app/Models/User.php 是否包含:
php
Namespace AppModels;
use IlluminateFoundationAuthUser as Authenticatable;
use IlluminateNotificationsNotifiable;
use IlluminateContractsAuthCanResetPassword;
class User extends Authenticatable implements CanResetPassword
{
use Notifiable;
}
生成并运行迁移、安装通知与邮件配置
执行以下命令生成密码重置数据表:
php artisan make:migration create_password_reset_Tokens_table- 编辑生成的迁移文件,确保它使用
password_reset_tokens表(Laravel 10.27+ 默认表名),内容类似:
Schema::create(‘password_reset_tokens’, function (Blueprint $table) {
$table->String(’email’)->primary();
$table->string(‘token’);
$table->timestamp(‘created_at’)->Nullable();
});
然后运行:php artisan migrate
确认 邮箱 服务已配置(如 SMTP 或 Mailgun),在 .env 中设置:
mail_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=you@gmail.com
MAIL_PASSWORD=your-app-password
MAIL_ENCRYPTION=tls
注册 路由 与控制器
Laravel 提供了现成的认证脚手架。推荐使用:
-
php artisan make:auth(Laravel ≤ 5.8) - Laravel 9+ 推荐直接引入
laravel/breeze或laravel/jetstream,它们已预置完整密码重置页面与逻辑 - 若手动集成,确保在
routes/web.php中包含:
Auth::routes([‘reset’ => true]);
这会自动注册以下路由:
-
GET /password/reset→ 显示邮箱输入页(ForgotPasswordController@showLinkRequestForm) -
POST /password/email→ 发送重置邮件(ForgotPasswordController@sendResetLinkEmail) -
GET /password/reset/{token}→ 显示新密码表单(ResetPasswordController@showResetForm) -
POST /password/reset→ 处理新密码提交(ResetPasswordController@reset)
自定义视图(可选但推荐)
复制默认视图到项目中以便修改:
-
php artisan vendor:publish --tag=laravel-notifications(发布通知模板) -
php artisan vendor:publish --tag=laravel-mail(发布邮件样式) - 重置页面位于
resources/views/auth/passwords/,包括:email.blade.php(邮件正文)、reset.blade.php(重置表单)、request.blade.php(邮箱请求页)
例如修改 reset.blade.php 中的表单字段(需保留隐藏的 token 和 email):
@csrf
red>
基本上就这些。不需要重写核心逻辑,重点是配对路由、数据库、邮件和视图四个环节。中间任何一步断开(比如没发邮件、token 过期、表单漏字段)都会导致失败,调试时优先查日志和邮件驱动是否生效。
以上就是 Laravel 如何实现用户 密码重置 功能?(完整流程代码)的详细内容,更多请关注 php 中文网其它相关文章!