Download the PHP package abronin/laravel-parse without Composer

Note on copyright and authorship

This package is a fork of parziphal/parse upgraded to be compatible with modern versions of Laravel. All the respect and appreciation for the project should be sent to the Parziphal (real author).

Laravel Parse

This library pretends to make Parse usable in a Eloquent-like manner. For Laravel 5.2+, 6.x and 7.x.

Features

• Initialize Parse automatically.
• Use facade classes that wraps Parse's classes, exposing an Eloquent-like interface.
• Enabled to work with Parse's relations.
• User authentication with username/password combinations and/or with Facebook.
• Command to create ObjectModels (artisan parse:model SomeModel).

Setup

Install the library with Composer:

composer require parziphal/parse

Add the service provider in your config/app.php file:

Publish the configuration file by running:

php artisan vendor:publish --tag=parse

The command creates a file at config/parse.php, where you can set your Parse server configuration, but instead of editing that file, you can set your configuration in your .env file by setting the following variables:

PARSE_APP_ID=Your_App_ID
PARSE_REST_KEY=REST_API_key
PARSE_MASTER_KEY=Master_key
PARSE_SERVER_URL=http://127.0.0.1:1337
PARSE_MOUNT_PATH=/parse

The REST_API_key variable is optional as Parse doesn't require that key anymore.

ObjectModels

Create models extending the Parziphal\Parse\ObjectModel class:

And that's it. However, remember that you can use the Artisan command php artisan parse:model SomeModel to easily create a model.

ObjectModels behave just as an Eloquent model, so you can do stuff like:

Relations

Supported relations are:

• belongsTo and its complement hasMany
• belongsToMany, which stores parents ids in an array, and its complement hasManyArray

You use them like this:

Queries

Parziphal\Parse\Query is a wrapper for Parse\ParseQuery, which also behaves like Eloquent Builder:

Using Master Key

Objects and queries can be configured to use Master Key with the $useMasterKey property. This can be done at class level, at instantiation, or by using the setter method:

Log in with Parse

Note: On Laravel 5.4 the web middleware group has an entry for \Illuminate\Session\Middleware\AuthenticateSession (which is disabled by default). Activating this middleware will cause the "remember me" feature to fail.

Make sure your User class extends Parziphal\Parse\UserModel. You could extend instead from Parziphal\Parse\Auth\UserModel, which is a authentication-ready User class:

Now we have to configure both the web guard and the users provider, so open config/auth.php, and make the following changes:

There are 3 provider drivers available:

• parse which requires users to have a username and a password
• parse-facebook which requires users to identify using their Facebook account
• parse-any which lets users authenticate with either username/password or Facebook

Log in with Facebook

You can use the Parziphal\Parse\Auth\AuthenticatesWithFacebook trait in your auth controller along with (not instead of) Laravel's Illuminate\Foundation\Auth\AuthenticatesUsers trait. The AuthenticatesWithFacebook trait has methods to handle Facebook authentication/registration. Just bind the method (or methods) you need to a route and you're ready to go.

Below is the interface of the authentication/registration trait. Note that it can respond in two ways: with a redirection (the *Redirect methods), or with JSON (the *Api methods), which will respond with the $apiResponse array, which is there so you can customize it.

The trait expects to find the user's Facebook ID as the id parameter, and their access token as the access_token parameter.

Log in with username/password

There are things to take into consideration regarding this:

• The validator returned by the validator method of Laravel's default registration controller has a unique constraint on the email parameter, which will trigger database searches, leading to an error; make sure to remove that unique constraint.

• You'll also have to change the create method according to your needs. It could look like this:

Notice that the email is stored as the username, this is because on Parse, the username field is the login name of the user, so if you require users to login using their email, you'll have to store their email under the username key.

Inspiration from

• GrahamCampbell's Laravel-Parse
• HipsterJazzbo's LaraParse

License

MIT