README

Artisan commands for generating passwords, changing user passwords, listing users, and amending user email addresses in Laravel 12 and 13 applications.

Why?

If you've ever had to jump onto a host, or into a container, because you don't have UI access (or if there's an issue) and you just need to quickly reset a password or alter a user somehow. If you don't want to memorise a bunch of SQL commands. If you just need to do user management quickly and easily.

... then perhaps this little package can help.

Installation

Available on Packagist: https://packagist.org/packages/newtovaux/laravel-console-user-tools

Source code: https://github.com/newtovaux/laravel-console-user-tools

This package supports Laravel 12 and 13 on PHP 8.3+.

composer require newtovaux/laravel-console-user-tools

Optional

php artisan vendor:publish --tag=user-tools-config

Commands

Generate a password

php artisan user-tools:create
php artisan user-tools:create --length=24
php artisan user-tools:create --no-symbols
php artisan user-tools:create --length=32 --no-symbols

Change a user's password

php artisan user-tools:user-password dan@example.com
php artisan user-tools:user-password dan@example.com --password='new-password-123'
php artisan user-tools:user-password dan@example.com --generate
php artisan user-tools:user-password dan@example.com --generate --length=24
php artisan user-tools:user-password 15 --column=id
php artisan user-tools:user-password 15 --column=id --password='new-password-123'

List all users

php artisan user-tools:list-users
php artisan user-tools:list-users --limit=50

Change a user's email address

php artisan user-tools:user-amend-email dan@example.com
php artisan user-tools:user-amend-email 15 --column=id
php artisan user-tools:user-amend-email dan@example.com --email=new@example.com
php artisan user-tools:user-amend-email 15 --column=id --email=new@example.com

Configuration

If you want to override the defaults, publish the config file:

php artisan vendor:publish --tag=user-tools-config

Available options:

return [
    'user_model' => env('USER_TOOLS_USER_MODEL', config('auth.providers.users.model', App\Models\User::class)),
    'lookup_column' => env('USER_TOOLS_LOOKUP_COLUMN', 'email'),
    'generated_length' => (int) env('USER_TOOLS_GENERATED_LENGTH', 20),
];

These settings let you:

use a custom Eloquent user model
change the default lookup column from email to something else
set a default generated password length for user-tools:create

Practical notes

First, this package assumes your user table has a password column and your configured user model is Eloquent-backed, which is the normal Laravel setup.

Second, the package uses the application's configured auth user model by default so it stays reusable across projects instead of hard-coding App\Models\User. That aligns well with Laravel's package and auth conventions.

Third, the write commands are intentionally interactive. user-tools:user-password and user-tools:user-amend-email both ask for confirmation before saving changes.

Fourth, user-tools:user-amend-email will try the configured lookup column first and then fall back to id lookup when appropriate.

Fifth, user-tools:list-users outputs id and email, ordered by id, and supports --limit for large tables.

Security notes

Passing secrets directly on the command line can leak them into shell history. On shared machines or production hosts, prompting for a password is usually safer than using --password='...'.

The --copy option on user-tools:create is currently a placeholder and does not copy to the clipboard yet.

Tests

Install development dependencies, then run the test suite with Composer:

composer install
composer test

The package tests run with PHPUnit 11 and Orchestra Testbench against an in-memory SQLite database, so no separate test database setup is required.

GitHub Actions runs the suite against a compatibility matrix covering Laravel 12 and 13 on PHP 8.3, 8.4, and 8.5.

License

This software is released under the MIT license.

newtovaux / laravel-console-user-tools

Maintainers

Package info

Statistics

Security