A package to provide wordpress users in laravel authentication system.

v2.2.2 2020-04-27 17:58 UTC

This package is auto-updated.

Last update: 2020-04-27 17:59:38 UTC


Latest Stable Version Total Downloads Build Status Scrutinizer Code Quality Code Intelligence Status License

Laravel wordpress-auth-driver-laravel
5.2 to 5.5 ^1.0
5.6 to 7.8.x ^2.0


To install this package you will need

The best way to install this package is with the help of composer. Run

composer require ahsankhatri/wordpress-auth-provider

or install it by adding it to composer.json then run composer update

"require": {
    "ahsankhatri/wordpress-auth-provider": "^2.0",


Once you have installed this package from the composer, make sure to follow the below steps to configure.

To register authentication guard.

'guards' => [
    'wordpress' => [
        'driver' => 'session',
        'provider' => 'wordpress',
'providers' => [
    'wordpress' => [
        'driver' => 'eloquent.wordpress',
        'model' => MrShan0\WordpressAuth\Models\WordpressUser::class,
'passwords' => [
    'wordpress' => [
        'provider' => 'wordpress',
        'table' => 'password_resets',
        'expire' => 60,

Publish config file (optional)

php artisan vendor:publish --provider="MrShan0\WordpressAuth\WordpressAuthServiceProvider"

It will publish config file (config/wordpress-auth.php) where you can define your own connection type e.g wp-mysql. Make sure to fill prefix in config/database.php for wp_ prefix in your tables if you're using prefix in wordpress tabels.

For example:

'wp-mysql' => [
    'driver' => 'mysql',
    'host' => env('WP_DB_HOST', ''),
    'port' => env('WP_DB_PORT', '3306'),
    'database' => env('WP_DB_DATABASE', 'forge'),
    'username' => env('WP_DB_USERNAME', 'forge'),
    'password' => env('WP_DB_PASSWORD', ''),
    'unix_socket' => env('WP_DB_SOCKET', ''),
    'charset' => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix' => 'wp_',
    'prefix_indexes' => true,
    'strict' => true,
    'engine' => null,

Add following option along if using Laravel v7 (optional)

    // ...
    'url' => env('DATABASE_URL'),
    'options' => extension_loaded('pdo_mysql') ? array_filter([
    ]) : [],


password_resets table (from Laravel default auth mechanism) is required to hold reset password token. If you do not have password_resets table then use this migration instead


use Illuminate\Support\Facades\Schema;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class CreatePasswordResetsTable extends Migration
     * Run the migrations.
     * @return void
    public function up()
        Schema::create('password_resets', function (Blueprint $table) {

     * Reverse the migrations.
     * @return void
    public function down()


Alternatively, if you want to use a custom user model, you should have it extend MrShan0\WordpressAuth\Models\WordpressUser and specify the name of your model in config/auth.php under providers -> wordpress -> model.


If you've renamed your user_email column of wordpress database, you need to first publish configurations of this package if you've not already, extend the model as mentioned above and make sure you've override your changes in your $fillable property and config/wordpress-auth.php config file which is being used for authentication scaffolding and sending notifications.


You need to define wordpress guard explicitly to load the driver.



// or login using email and password
    'user_email' => 'demo@example.com',
    'user_pass' => 'quickbrownfox'

// get user object

// Update wordpress compatible password
$user->user_pass = app('wordpress-auth')->make('new_password');

// logout

You may also change default guard in config/auth.php then your code will look like


If you haven't set default guard and wanted to take advantage of Password Resets (Auth Scaffolding) in laravel. You may need to define guard and broker explicitly in Auth/ForgotPasswordController.php and Auth/ResetPasswordController.php as

 * Get the broker to be used during password reset.
 * @return \Illuminate\Contracts\Auth\PasswordBroker
public function broker()
    return \Password::broker('wordpress');

 * Get the guard to be used during password reset.
 * @return \Illuminate\Contracts\Auth\StatefulGuard
protected function guard()
    return \Auth::guard('wordpress');




Thanks to the community of Laravel.

Copyright and License

Copyright (c) 2016 Ahsaan Muhammad Yousuf, MIT License