Download the PHP package klaravel/ntrust without Composer

On this page you can find all versions of the php package klaravel/ntrust. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?
klaravel/ntrust
Rate from 1 - 5
Rated 5.00 based on 1 reviews

Informations about the package ntrust

NTRUST Multi-User Roles & Permissions (Laravel 5.4)

Ntrust is a succinct and flexible way to add Role-based Permissions to Laravel 5.4.

Original Package: https://github.com/Zizaco/entrust

Contents

Installation

In order to install Laravel 5 Ntrust, just add

"klaravel/ntrust": "1.1.*"

to your composer.json. Then run composer install or composer update.

or you can run the composer require command from your terminal:

composer require klaravel/ntrust

Then in your config/app.php add

in the providers array and

to the aliases array.

If you are going to use Middleware (requires Laravel 5.1 or later) you also need to add

to routeMiddleware array in app/Http/Kernel.php.

Configuration

Just use php artisan vendor:publish and a ntrust.php file will be created in your app/config directory.

See that file to get more detail like how to add multiple users. Default we added two users example like normal user and admin.

User relation to roles

Now generate the Ntrust migration:

Profile {name} name of profile which you have in file config/ntrust.php section profiles.

It will generate the <timestamp>_<user>_ntrust_setup_tables.php migration. You may now run it with the artisan migrate command:

After the migration, four new tables will be present like below or whatever you have entered table name in config/ntrust.php configuration file.

Models

Role

Create a Role model inside app/Role.php using the following example:

The Role model has three main attributes:

Both display_name and description are optional; their fields are nullable in the database.

Permission

Create a Permission model inside app/Permission.php using the following example:

The Permission model has the same three attributes as the Role:

In general, it may be helpful to think of the last two attributes in the form of a sentence: "The permission display_name allows a user to description."

User

Next, use the NtrustUserTrait trait in your existing User model. For example:

This will enable the relation with Role and add the following methods roles(), hasRole($name), can($permission), and ability($roles, $permissions, $options) within your User model.

Don't forget to dump composer autoload

And you are ready to go.

Soft Deleting

The default migration takes advantage of onDelete('cascade') clauses within the pivot tables to remove relations when a parent record is deleted. If for some reason you cannot use cascading deletes in your database, the NtrustRole and NtrustPermission classes, and the HasRole trait include event listeners to manually delete records in relevant pivot tables. In the interest of not accidentally deleting data, the event listeners will not delete pivot data if the model uses soft deleting. However, due to limitations in Laravel's event listeners, there is no way to distinguish between a call to delete() versus a call to forceDelete(). For this reason, before you force delete a model, you must manually delete any of the relationship data (unless your pivot tables uses cascading deletes). For example:

Usage

Concepts

Let's start by creating the following Roles and Permissions:

Next, with both roles created let's assign them to the users. Thanks to the HasRole trait this is as easy as:

Now we just need to add permissions to those Roles:

Checking for Roles & Permissions

Now we can check for roles and permissions simply by doing:

Both hasRole() and can() can receive an array of roles & permissions to check:

By default, if any of the roles or permissions are present for a user then the method will return true. Passing true as a second parameter instructs the method to require all of the items:

You can have as many Roles as you want for each User and vice versa.

The Ntrust class has shortcuts to both can() and hasRole() for the currently logged in user:

You can also use placeholders (wildcards) to check any matching permission by doing:

User ability

More advanced checking can be done using the awesome ability function. It takes in three parameters (roles, permissions, options):

Either of the roles or permissions variable can be a comma separated string or array:

This will check whether the user has any of the provided roles and permissions. In this case it will return true since the user is an admin and has the create-post permission.

The third parameter is an options array:

Here is an example output:

The Ntrust class has a shortcut to ability() for the currently logged in user:

Blade templates

Three directives are available for use within your Blade templates. What you give as the directive arguments will be directly passed to the corresponding Ntrust function.

Middleware

You can use a middleware to filter routes and route groups by permission or role

It is possible to use pipe symbol as OR operator:

To emulate AND functionality just use multiple instances of middleware

For more complex situations use ability middleware which accepts 3 parameters: roles, permissions, validate_all

Short syntax route filter

To filter a route by permission or role you can call the following in your app/Http/routes.php:

Both of these methods accept a third parameter. If the third parameter is null then the return of a prohibited access will be App::abort(403), otherwise the third parameter will be returned. So you can use it like:

Furthermore both of these methods accept a fourth parameter. It defaults to true and checks all roles/permissions given. If you set it to false, the function will only fail if all roles/permissions fail for that user. Useful for admin applications where you want to allow access for multiple groups.

Route filter

Ntrust roles/permissions can be used in filters by simply using the can and hasRole methods from within the Facade:

Using a filter to check for a role:

As you can see Ntrust::hasRole() and Ntrust::can() checks if the user is logged in, and then if he or she has the role or permission. If the user is not logged the return will also be false.

Troubleshooting

If you encounter an error when doing the migration that looks like:

Then it's likely that the id column in your user table does not match the user_id column in role_user. Make sure both are INT(10).

When trying to use the NtrustUserTrait methods, you encounter the error which looks like

Class name must be a valid object or a string

then probably you don't have published Ntrust assets or something went wrong when you did it. First of all check that you have the ntrust.php file in your app/config directory. If you don't, then try php artisan vendor:publish and, if it does not appear, manually copy the /vendor/klaravel/ntrust/src/config/config.php file in your config directory and rename it ntrust.php.

License

Ntrust is free software distributed under the terms of the MIT license.

Contribution guidelines

Support follows PSR-1 and PSR-4 PHP coding standards, and semantic versioning.

Please report any issue you find in the issues page.
Pull requests are welcome.


All versions of ntrust with dependencies

PHP Build Version
Package Version
Requires illuminate/console Version 5.*
illuminate/support Version 5.*
illuminate/cache Version 5.*
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package klaravel/ntrust contains the following files

Loading the files please wait ....