shibly/password-notify

Laravel package to notify user of password changes.

v1.0.3 2025-06-11 04:33 UTC

Requires

• php: ^8.1
• illuminate/bus: ^11.0|^12.0
• illuminate/database: ^11.0|^12.0
• illuminate/mail: ^11.0|^12.0
• illuminate/notifications: ^11.0|^12.0
• illuminate/support: ^11.0|^12.0

MIT

README

This Laravel package automatically sends a notification to users when their password is changed. It does not store or email the new password.

Installation

You can easily install this package via Composer:

composer require shibly/password-notify

Publish Configuration (Optional)

Publish the configuration file to customize package behavior:

php artisan vendor:publish --tag=config

This will publish passwordnotify.php into your application's config directory.

Configuration

Modify config/passwordnotify.php to define the password field:

return [
    'password_field' => 'password',
];

You can customize this field if your application uses a different naming convention.

Usage

When changing a user's password, the notification will automatically be sent if the configured password field changes:

use Illuminate\Support\Facades\Hash;

$user = auth()->user();
$user->update([
    'password' => Hash::make('MySecurePassword123'),
]);

You don't need to do anything else. The package listens for password changes and sends a notification automatically.

Example Email Notification

The user will receive a notification similar to:

Hello, John Doe!

Your password has been successfully changed.

If you did not change your password, please contact support immediately.

Queueing Notifications (Recommended)

By default, notifications will be queued. Ensure your Laravel queue worker is running:

php artisan queue:work

Requirements

• PHP ^8.1
• Laravel ^11.0|^12.0

Contributing

Feel free to submit issues or pull requests to improve this package!

License

This package is open-source and licensed under the [MIT license].