PHPackages                             sectheater/artify - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI & Console](/categories/cli)
4. /
5. sectheater/artify

ActiveLibrary[CLI & Console](/categories/cli)

sectheater/artify
=================

The Missing Laravel Artisan Commands

v2.0.5(6y ago)953.4k↓66.7%61MITPHP

Since Jun 5Pushed 6y ago2 watchersCompare

[ Source](https://github.com/SecTheater/artify)[ Packagist](https://packagist.org/packages/sectheater/artify)[ RSS](/packages/sectheater-artify/feed)WikiDiscussions master Synced today

READMEChangelog (7)DependenciesVersions (8)Used By (1)

[![StyleCI](https://camo.githubusercontent.com/3c75450ba23f587cee28c9f8f527292f4767215cc3ccbe500de3d9a83301156c/68747470733a2f2f6769746c61622e7374796c6563692e696f2f7265706f732f363735343336352f736869656c643f6272616e63683d6d6173746572)](https://gitlab.styleci.io/repos/6754365)

[![SensioLabsInsight](https://camo.githubusercontent.com/f8048a179e2268c3de9bffcbbf05c194b26037c8ff1e5c6c2c00b5dae4a1998a/68747470733a2f2f696e73696768742e73656e73696f6c6162732e636f6d2f70726f6a656374732f38326533356161302d326136372d343264642d396161652d3465656230656338346664622f6269672e706e67)](https://insight.sensiolabs.com/projects/82e35aa0-2a67-42dd-9aae-4eeb0ec84fdb)

[![Latest Version on Packagist](https://camo.githubusercontent.com/337bc2fd8a112e78c4df9f7e543568296779ea5680ed05e3c805e7b17501d2ca/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f736563746865617465722f6172746966792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sectheater/artify)

[![Total Downloads](https://camo.githubusercontent.com/a0c596b67e0b67739b8a9e2d45c62a2ac23e40017f9d6936d22fa18382ab6693/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f736563746865617465722f6172746966792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sectheater/artify)

 Made with ❤️ by SecTheater Foundation

> Artify CheatSheet will be availble soon

---

Laravel is a great framework and it provides us the ability to create our custom artisan commands, so why not to have a couple of commands that makes your life easier while develping your application.

If you have any inspiration about a new command , or you do something routinely and you want a command for that , Please do not hesitate at all.
================================================================================================================================================

[](#if-you-have-any-inspiration-about-a-new-command--or-you-do-something-routinely-and-you-want-a-command-for-that--please-do-not-hesitate-at-all)

Artify cares about the commands that you should have within your application, for now, it ships with commands that will help you to create files that laravel don't supply a command for them till now such as Repositories,Observers,Responsable Interface,facades and so on..

Installation Steps
------------------

[](#installation-steps)

### 1. Require the Package

[](#1-require-the-package)

After creating your new Laravel application you can include the Artify package with the following command:

```
composer require sectheater/artify:dev-master
```

If your laravel version is 5.5+, you don't need to register ArtifyServiceProvider as It"s automatically discovered, unless that you got to register it manually in your config/app.php

```
"providers" => [
   // other providers
   Artify\Artify\ArtifyServiceProvider::class
]

```

### 2. Add the DB Credentials & APP\_URL

[](#2-add-the-db-credentials--app_url)

Next make sure to create a new database and add your database credentials to your .env file:

```
DB_HOST=localhost
DB_DATABASE=homestead
DB_USERNAME=homestead
DB_PASSWORD=secret

```

### 3. Getting Your Environment Ready.

[](#3-getting-your-environment-ready)

#### Just Run The following command.

[](#just-run-the-following-command)

```
	php artisan artify:install -c 20
```

##### Command Interpretation

[](#command-interpretation)

1- It publishes the roles migrations,its seed, and the config file that artify will use.

2- "-c" stands for the caching whether to enable or not, 20 stands for the number of minutes that's going to be cached.

If you don't want to enable the cache just remove the -c and the number to become like that

```

php artisan artify:install

```

3- It asks about the Role model, and the permissions column which will artify handle during the generating files related to roles.

> Artify Provides you the ability to set your custom namespace and your custom user model within config/artify.php

[![Installation Preview](https://camo.githubusercontent.com/1d6f1cfba77296aac23141df396b8eaf1268be38a1d203ab6e008fba82aadc20/687474703a2f2f736563746865617465722e6f72672f6173736574732f696d616765732f646f632f6172746966792e706e67)](https://camo.githubusercontent.com/1d6f1cfba77296aac23141df396b8eaf1268be38a1d203ab6e008fba82aadc20/687474703a2f2f736563746865617465722e6f72672f6173736574732f696d616765732f646f632f6172746966792e706e67)

Now everything is set, Let's dive into the Commands.

### 4. Commands that artify covers.

[](#4-commands-that-artify-covers)

---

#### 4.1 Create an Observer

[](#41-create-an-observer)

Observer is typically observing for a particular eloquent event. On happening this event, Observer is fired, You can read about it at the [documentation](https://laravel.com/docs/5.6/eloquent).

```
  // ? means optional.
 // php artisan artify:observer
 // creates a model for this observer in case the model doesn't exist
 // registering on the provider is always set to true, if you don't want to register the observer just type "-p"

 php artisan artify:observer PostObserver -m

```

The upon command generates an observer file within your App/Observers with name of PostObserver The methods there now have Post Model as parameter passed, The ignored methods while creating the observer ( which won't be within this file) are created and updated.

---

#### 4.2 Create A Responsable Interface

[](#42-create-a-responsable-interface)

Responsable Interface is a Laravel 5.5 feature that you should use to make your controller slim, you can see a [tutorial](https://www.youtube.com/watch?v=yKNK6MZdSrY) about it.

```
	php artisan artify:response
	// Example , please try to follow the convention of naming.. Response
    php artisan artify:response PostShowResponse
```

The command upon is going to create you a new file with the name you attached under App/Responses

---

#### 4.3 Synchronozing Your Roles table with Policy & Gates

[](#43-synchronozing-your-roles-table-with-policy--gates)

**This command is in charge of converting the available roles within your database into policy and gates**

It's preferable to follow the convention of naming the roles as mentioned in the Roles Table Seeder

Artify also supplies you with the migration for roles, if you are going to change the permissions column, don't forget to update that within the config file

Permissions column should be an array, if they are jsonb in your database, use the accessors, or observers, or use casts property to convert permissions to an array

```
// Role Model

protected $casts = ["permissions" => "array"];
```

By Default this command requires the hasRole method ( it should return boolean ) , you can create your custom one within user model, or just import the Roles trait

```
 use Artify\Artify\Traits\Roles\Roles;

 Class User Extends Model {
   use Roles;
 }

```

This method is required to check whether the user has a specific role to access somewhere or not, It's used within the gates. Feel free to change the gates"s logic to suit your needs.

```
  php artisan artify:register-authorization

```

By Firing this command, you can use the can middleware anywhere within your route file

```
  Route::get("/post/create","PostController@create")->middleware("can:create-post");

```

also you can access the method can anywhere in your project.

```
 if($user->can("create-post"))
 // do something
```

---

#### 4.4 Assign User To A Specific Rank.

[](#44-assign-user-to-a-specific-rank)

This command is just there to save you a couple of minutes whenever you assign a user manually to a specific role through database.

```
 php artisan artify:assign
 //  Example :
 php artisan artify:assign Alex admin
```

---

#### 4.5 Create A Repository

[](#45-create-a-repository)

Repository patten is absolutely a powerful pattern that you should use in order to separate logic from your database layer ( model ) and keep your model cleaner.

```
 php artisan artify:repository  (-m?) (-f?)
 // -m stands for the model associated with the repository.
 // -f create a facade for this repository, so you can call it immediately , i.e you can just do that anywhere "\MyRepository::method();"
```

---

#### 4.6 Generate a facade.

[](#46-generate-a-facade)

```
php artisan artify:facade
```

---

#### 4.7 Generate CRUD

[](#47-generate-crud)

Well, This artifier is really a beast, it could save you up to 20 minutes or something , It helps you to generate the following

- Model
- Resource Controller with the common logic you mostly do within your methods.
- Request Form files for your store and update methods.
- Resource Route within your web file
- If Repository Option is enabled, It will create you the repository associating with the model.

```
 php artisan artify:crud  (-r?)
 // -r is optional , it will generate you the repository.
```

---

#### 4.8 ADR Installation

[](#48-adr-installation)

You may know the ADR pattern, out of the blue artify supports this pattern, It's an alternative of MVC that we personally think it's better, if you don't know much about it yet, we recommend you getting started with this [link](https://github.com/pmjones/adr) , If you a tutorial fan, you can see this [course](https://codecourse.com/watch/action-domain-responder-with-laravel)

This command actually sets up the environment by publishing the standards of adr inside your App\\App directory, which will create the directory in case you don't have it.

```
php artisan adr:install
```

---

#### 4.9 ADR Generation

[](#49-adr-generation)

This command is actually powerful as it ships with various options consisting of

- create model, migration, repository, factory "-m"
- create resource "-c"
- create responder "-r"
- create action "-a"
- create service "-s"
- create everything "-A"

Let's start with the basics

```
php artisan adr:generate Addresses IndexAddress -sra
```

This is going to create you Addresses folder under the app directory and will look like the following structure :

```
├── App

├── Addresses

│   ├── Actions

│   │   ├── IndexAddressAction.php

│   ├── Domain

│   |   ├── Services

|	|      ├── IndexAdressService.php

│   ├── Responders

│   |   ├── IndexAddressResponder

└── ...

```

Which in essence creates you Action, Service, Responder.

You can also model, associated with the repository and migration

```
php artisan adr:generate Addresses -m
```

Note that passing the filename in this case will be ignored, as the domain is only our main concern in this case, anyways this will generate you the repository, model, migration and the factory.

You can also create a resource for this domain using the -c option.

```
	php artisan adr:generate Addresses -c
```

You can also combine them all at once using the -A option.

```
 php artisan adr:generate Videos IndexVideo -A
```

This will create you Responder,Action, and Domain components.

Note that action,responder,service will contain of IndexVideo file only, for creating other files, use the command again and mention their names again.

### 5.0 Roles Trait

[](#50-roles-trait)

This trait is there to handle the authorization process for artify commands , but feel free to use it for your own purposes. It contains of a few methods that"s really helpful for you to handle authorization anywhere within your application. Let"s dive into the Methods there.

> The Trait supports checking roles within your roles table and the users table ( secondary permissions to be assigned for users )

#### Authorization Methods.

[](#authorization-methods)

##### 1.0 hasRole Method

[](#10-hasrole-method)

This method accepts only one argument and it should be string, the string should match a role name within your permissions column either on users table or roles table.

```
$user = \App\User::first();

dd($user->hasRole("create-post")); // if the current logged in user has the ability to "create-post", it will return true
```

The method is going to search for the permission associated with the user either on roles table or users table.

##### 2.0 hasAnyRole Method

[](#20-hasanyrole-method)

I think you"ve guessed what"s going on here, It searches for all of the roles you pass and returns true on the first role that a user may have

```
  dd($user->hasAnyRole(["create-post","foo-bar","approve-post"])); // returns true/false;
```

##### 3.0 hasAllRole Method

[](#30-hasallrole-method)

This method accepts one argument, it should be an array containing of the permissions you are checking for.

 This method checks on all the roles passed, whether the user has them all or not. ```
  dd($user->hasAllRole(["foo-bar","upgrade-user"])); // returns true/false;
```

##### 3.0 inRole Method

[](#30-inrole-method)

This method checks if the user"s rank is typically equal to the passed argument.

 - Slug that represents your permissions in role table. - returns boolean ```
 dd($user->inRole("admin"); // This slug exists within the seeder
```

---

#### Permissions Handling Methods.

[](#permissions-handling-methods)

**The permissions are assigned to the current user you are working on only. i.e you can retrieve the user by finding him/her or get the authenticated user then handle his/her permisisons.**

##### 1.0 Add Permission

[](#10-add-permission)

This method accepts two arguments which are the permissions and boolean value.

 - Permissions can be either string or array. - boolean value represents the ability of the user to do mentioned permission. - returns boolean. ```
   $user->addPermission("create-custom-post"); // second parameter is set to true by default, so the added permission is available for this user.
   $user->addPermission("create-something",false) // the user isn\'t allowed to "create-something" now.
   $user->addPermission(["create-something" => true , "can-push-code" => false])
   /* you don\'t need the second parameter now as the key and value of this array is going to be in charge of handling the permissions. */

```

---

##### 2.0 Update Permission

[](#20-update-permission)

 This method accepts three arguments

 - Permission , should be a string. - boolean value represents the ability of the user to do mentioned permission. - boolean value , represents creating the permission if it doesn't exist. - returns boolean. ```
 $user->updatePermission("create-post"); // this will update the permission to set it to true.
 $user->updatePermission("create-post",false); // this will update the permission to set it to false
 $user->updatePermission("foo-bar",false,true); // this will create the permission if it doesn\'t exist and set it to false.
```

---

##### 3.0 Remove Permission

[](#30-remove-permission)

This method accepts one argument only representing the permission

 - n of permissions can be passed a separate parameter. - returns boolean If the permission isn't set, an exception is thrown.

```
  $user->removePermission("create-post"); // returns boolean
  $user->removePermission("create-post","delete-post","whatever-role",...); // returns boolean
```

 For Further Resources, Here is an article on \[medium\] :

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity31

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 88.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~112 days

Recently: every ~72 days

Total

7

Last Release

2220d ago

Major Versions

v1.0 → v2.0.02019-01-21

### Community

Maintainers

![](https://www.gravatar.com/avatar/1d2dd233c9a0eba9b86887b347c4ff4d7f016c06cafac266c2a8dd72da1aaa78?d=identicon)[SecTheater](/maintainers/SecTheater)

---

Top Contributors

[![secmohammed](https://avatars.githubusercontent.com/u/40739458?v=4)](https://github.com/secmohammed "secmohammed (23 commits)")[![mohamed-abdelrhman](https://avatars.githubusercontent.com/u/26941732?v=4)](https://github.com/mohamed-abdelrhman "mohamed-abdelrhman (3 commits)")

---

Tags

artifylaravellaravel-5-packagelaravel-clilaravel-commandslaravel commandsArtifyArtifier

### Embed Badge

![Health badge](/badges/sectheater-artify/health.svg)

```
[![Health](https://phpackages.com/badges/sectheater-artify/health.svg)](https://phpackages.com/packages/sectheater-artify)
```

###  Alternatives

[wp-cli/wp-cli

WP-CLI framework

5.0k17.2M319](/packages/wp-cli-wp-cli)[consolidation/annotated-command

Initialize Symfony Console commands from annotated command class methods.

22569.8M18](/packages/consolidation-annotated-command)[chi-teck/drupal-code-generator

Drupal code generator

26947.8M5](/packages/chi-teck-drupal-code-generator)[seld/cli-prompt

Allows you to prompt for user input on the command line, and optionally hide the characters they type

24725.8M17](/packages/seld-cli-prompt)[illuminate/console

The Illuminate Console package.

12944.1M5.1k](/packages/illuminate-console)[php-tui/php-tui

Comprehensive TUI library heavily influenced by Ratatui

589747.0k6](/packages/php-tui-php-tui)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)