Allow Facebook users with empty emails

README.md

@@ -656,6 +656,10 @@ Naturally you'll need to create a column for every other piece of information yo
 
 You can store the access token in the database if you need to make requests on behalf of the user when they are not browsing your app (like a 3AM cron job). But in general you won't need to store the access token in the database.
 
+Also you have to make the `email` field nullable. That's because [email permission](https://developers.facebook.com/docs/facebook-login/permissions/#reference-email) for Facebook apps is optional. It means users may choose not to share their email address with your app. Also even if you request the email permission it is not guaranteed you will get an email address. For example, if someone signed up for Facebook with a phone number instead of an email address, the email field may be empty.
+
+By default the `email` field is not null and has a unique index on it. It means it can only accept one user with empty email. Starting from the second user you'll get the database error 'Duplicate entry for unique key'. To fix this just make `email` nullable.
+
 You'll need to generate a migration to modify your `users` table and add any new columns.
 
 > **Note:** Make sure to change `<name-of-users-table>` to the name of your user table.
@@ -681,6 +685,8 @@ class AddFacebookColumnsToUsersTable extends Migration
             $table->bigInteger('facebook_user_id')->unsigned()->index();
             // Normally you won't need to store the access token in the database
             $table->string('access_token')->nullable();
+            // Make `email` nullable
+            $table->string('email')->nullable()->change();
         });
     }
 
@@ -692,6 +698,7 @@ class AddFacebookColumnsToUsersTable extends Migration
                 'facebook_user_id',
                 'access_token'
             );
+            $table->string('email')->nullable(false)->change();
         });
     }
 }