DEV Community: Oussama

Count Models and Get Detailed Analytics With Laravisit Package

Oussama — Tue, 15 Feb 2022 00:00:22 +0000

Introduction

Laravisit by @ousid is a package to keep track of your pages & understand your audience, by providing a helpful API methods, easy to implement, and easy to use.

Prerequisite

You need to know the following:

Need to know PHP
Basics on Laravel & the artisan command Laravel
Basics on composer [Composer][https://getcomposer.org]

Why this package?

If you want to keep track of your pages visits, and understand your audience (users), this package is built for you, to save you time and make your development experience simpler.

Installation

You can install the package via composer:

composer require coderflexx/laravisit

You can publish the config file with:

vendor:publish --provider="Coderflex\\Laravisit\\LaravisitServiceProvider"

then, run database migration

php artisan migrate

This is the contents of the published config file:

return [
    /*
    |--------------------------------------------------------------------------
    | User Namespace
    |--------------------------------------------------------------------------
    |
    | This value informs Laravist which namespace you will be 
    | selecting to get the user model instance
    | If this value equals to null, "\Coderflex\Laravisit\Models\User" will be used 
    | by default.
    |
    */
    'user_namespace' => "\Coderflex\Laravisit\Models\User",
];

Usage

See more details and use cases on the package docs page.

Changelog

You can follow the changes on this package by accessing the changelog or the releases

Contributing

If you want to contribute, feel free to read the CONTRIBUTING guidelines, and make your PR

Conclusion

Today we s learned about Laravisit package, and how to use it. To make our development process easier and save us time.

Decorate Your Model Attributes Using Laravel Presenter Package

Oussama — Mon, 14 Feb 2022 23:34:12 +0000

Introduction

Laravel Presenter by @ousid is a clean way to decorate your models,
and incrementally refactor from the simplest solution to a clean, reusable system.

Prerequisite

You need to know the following:

Need to know PHP
Basics on Laravel & the artisan command Laravel
Basics on composer [Composer][https://getcomposer.org]

Why this package?

Sometimes we need to present some custom attributes and re-use them in many places in our app, and the simplest way is to put them inside your model class, but is it efficient?
This page allows you to make a place for all your custom attribute methods and decorate them to use them wherever you want, and help you to maintain/refactor your code easily.

Installation

You can install the package via composer:

composer require coderflexx/laravel-presenter

You can publish the config file with:

vendor:publish --provider="Coderflex\LaravelPresenter\LaravelPresenterServiceProvider"

This is the contents of the published config file:

return [

    /*
    |--------------------------------------------------------------------------
    | Presenter Namespace
    |--------------------------------------------------------------------------
    |
    | This value informs LaravelPresenter which namespace you will be 
    | selecting to store your presenters by default.
    | If this value equals to null, "App\Presenter" will be used 
    | by default.
    |
    */

    'presenter_namespace'   => 'App\\Presenters',
];

Usage

The implementation of this package is so simple, all what you need to do is the following:

Model Implementation

Implement CanPresent Interface
Use UsesPresenters Trait

use Coderflex\LaravelPresenter\Concerns\CanPresent;
use Coderflex\LaravelPresenter\Concerns\UsesPresenters;
// ...

class User extends Authenticatable implements CanPresent
{
    use UsesPresenters;

    // ...
}

Create New Model Presenter class

This package gives you an easy way to generate new Presenter class, all you need to do is to use presenter:make command.

php artisan presenter:make UserPresneter

UserPresenter in our case, leaves by default in App\Presenters.

This is the contents of the UserPresenter file:

<?php

namespace App\Presenters;

use Coderflex\LaravelPresenter\Presenter;

class UserPresenter extends Presenter
{
    // 
}

If you want to change the directory, you have two options.

First options is to set the full namespace while you're creating the presenter class

php artisna presneter:make App\Models\Presenter\UserPresenter

Or change presenter_namespace from config/laravel-presenter file.

return [
    ...

    'presenter_namespace'   => 'App\\Presenters',

    ...
];

Using the `Presenter` Generated Class

After you create the presenter class, you need to register it on the Model by adding the $presenters protected property:

use App\Presenters\UserPresenter;
use Coderflex\LaravelPresenter\Concerns\CanPresent;
use Coderflex\LaravelPresenter\Concerns\UsesPresenters;
// ...

class User extends Authenticatable implements CanPresent
{
    use UsesPresenters;

    protected $presenters = [
        'default' => UserPresenter,
    ];
}

By default, the type of your presenter class is default, but you can use as many of presenters you want, just by identifying the type in $presenters property.

Real Life Example

Now, after we generated the presenter class, and we implemented it successfully in our model, we can use it like so:

In your UserPresenter class or any presenter class you generated.

...
class UserPresenter extends Presenter
{
    public function fullName()
    {
        return "{$this->model->first_name} {$this->model->last_name}";
    }
}
...

We add a new method to present the fullName.

In your blade or any place you want, you can do:

$user->present()->fullName

Your application will show the full name from the method you added.

Adding Another Presenter Type:

Like I said above, by default the type will be deafult but, you can add more types as you need.

Here is an example:

use App\Presenters\UserPresenter;
use Coderflex\LaravelPresenter\Concerns\CanPresent;
use Coderflex\LaravelPresenter\Concerns\UsesPresenters;
// ...

class User extends Authenticatable implements CanPresent
{
    use UsesPresenters;

    protected $presenters = [
        'default' => UserPresenter,
        'setting' => UserSettingPresenter,
    ];
}

Generate new UserSettingPresenter

php artisan presenter:make UserSettingPresenter

Add anything to UserSettingPresenter method

...
class UserSettingPresenter extends Presenter
{
    public function lang()
    {
        return $this->model->settings->defaultLang;
    }
}
...

Finally, set setting as a type:

$user->present('setting')->lang;

By that, you can split your logic and make your code base even cleaner.

Changelog

You can follow the changes on this package by accessing the changelog or the releases

Contributing

If you want to contribute, feel free to read the CONTRIBUTING guidelines, and make your PR

Conclusion

Today we s learned about Laravel Presenter package, and how to use it. To make our development process easier and save us time.

Laravel 9 released, See What's new.

Oussama — Wed, 09 Feb 2022 13:13:05 +0000

Introduction

Laravel 9 is finally here! It comes with a ton of handy new features, from routes to database, and this is what we are going to discover in this article.

Prerequisite

Knowledge of PHP
Basic Knowledge of Laravel
PHP v8.0 at minimum

Releases Schedule

For LTS releases, such as Laravel 9, bug fixes are provided for 2 years and security fixes are provided for 3 years. These releases provide the longest window of support and maintenance. For general releases, bug fixes are provided for 18 months and security fixes are provided for 2 years. For all additional libraries, including Lumen, only the latest release receives bug fixes. In addition, please review the database versions supported by Laravel.

Version	PHP (*)	Release	Bug Fixes Until	Security Fixes Until
6 (LTS) (**)	7.2 - 8.0	September 3rd, 2019	January 25th, 2022	September 6th, 2022
7(-)	7.2 - 8.0	March 3rd, 2020	October 6th, 2020	March 3rd, 2021
8	7.3 - 8.1	September 8th, 2020	July 26th, 2022	January 24th, 2023
9 (LTS)	8.0 - 8.1	February 8th, 2022	February 8th, 2024	February 8th, 2025
10	8.0 - 8.1	February 7th, 2023	August 7th, 2024	February 7th, 2025

(-) End of life
() Supported PHP versions
(*) Security fixes only

Laravel 9 new features

New route:list look

when you type php artisan route:list you will see a brand-new design look, besides you can see which middleware applied to each route!

Route Groups

You may now use the controller method to define the common controller for all the routes within the group. Then, when defining the routes, you only need to provide the controller method that they invoke:

use App\Http\Controllers\OrderController;

Route::controller(OrderController::class)->group(function () {
    Route::get('/orders/{id}', 'show');
    Route::post('/orders', 'store');
});

Forced Scoped Bindings

you may now instruct Laravel to scope "child" bindings even when a custom key is not provided. To do so, you may invoke the scopeBindings method when defining your route:

use App\Models\Post;
use App\Models\User;

Route::get('/users/{user}/posts/{post}', function (User $user, Post $post) {
    return $post;
})->scopeBindings();

Or, you may instruct an entire group of route definitions to use scoped bindings:

Route::scopeBindings()->group(function () {
    Route::get('/users/{user}/posts/{post}', function (User $user, Post $post) {
        return $post;
    });
});

If you want to know more, you may take a look here

Blade Template Inline Rendering

Sometimes you may need to transform a raw Blade template string into valid HTML. You may accomplish this using the render method provided by the Blade facade. The render method accepts the Blade template string and an optional array of data to provide to the template:

use Illuminate\Support\Facades\Blade;

return Blade::render('Hello, {{ $name }}', ['name' => 'Oussama Sid']);

Similarly, the renderComponent method may be used to render a given class component by passing the component instance to the method:

use App\View\Components\HelloComponent;

return Blade::renderComponent(new HelloComponent('Oussama Sid'));

Optional Bootstrap 5 Pagination Views

Laravel now includes pagination views built using Bootstrap 5. To use these views instead of the default Tailwind views, you may call the paginator's useBootstrapFive method within the boot method of your App\Providers\AppServiceProvider class:

use Illuminate\Pagination\Paginator;

/**
 * Bootstrap any application services.
 *
 * @return void
 */
public function boot()
{
    Paginator::useBootstrapFive();
}

Brand new Ignition Page

Ignition, the open source exception debug page created by Spatie, has been redesigned from the ground up. The new, improved Ignition ships with Laravel 9.x and includes light / dark themes, customizable "open in editor" functionality, and more.

str() helper function

The str function returns a new Illuminate\Support\Stringable instance for the given string. This function is equivalent to the Str::of method:

$string = str('Oussama')->append(' Sid');

// Oussama Sid

If no argument is provided to the str function, the function returns an instance of Illuminate\Support\Str:


$string = str()->append('Oussama Sid')->uppercase();

// OUSSAMA SID

to_route() helper function

The to_route function generates a redirect HTTP response for a given named route, providing an expressive way to redirect to named routes from your routes and controllers:

return to_route('users.show', ['user' => 1]);

// equivalent to

return redirect()->route('user.show', ['user' => 1]);

Enum Attribute Casting

Enum casting is only available for PHP 8.1+

Eloquent now allows you to cast your attribute values to PHP enums. To accomplish this, you may specify the attribute and enum you wish to cast in your model's $casts property array:

Create PostStatus class inside app/Enums directory

namespace App\Enums\PostStatus;

enum PostStatus
{
    case Published;
    case Pending;
    case Archived;
    case Draft;
}

Inside your model:

use App\Enums\PostStatus;

/**
 * The attributes that should be cast.
 *
 * @var array
 */
protected $casts = [
    'status' => PostStatus::class,
];

Once you have defined the cast on your model, the specified attribute will be automatically cast to and from an enum when you interact with the attribute:

if ($post->status == PostStatus::Pending) {

    $post->status = PostStatus::Published;

    $post->save();
}

Brand-new Accessors & Mutators (Simplified)

Laravel 9.x offers a new way to define Eloquent accessors and mutators. In previous releases of Laravel, the only way to define accessors and mutators was by defining prefixed methods on your model like so:

public function getNameAttribute($value)
{
    return strtoupper($value);
}

public function setNameAttribute($value)
{
    $this->attributes['name'] = $value;
}

However, in Laravel 9.x you may define an accessor and mutator using a single, non-prefixed method by type-hinting a return type of Illuminate\Database\Eloquent\Casts\Attribute:

use Illuminate\Database\Eloquent\Casts\Attribute;

public function name(): Attribute
{
    return new Attribute(
        get: fn ($value) => strtoupper($value),
        set: fn ($value) => $value,
    );
}

Laravel 9 Release Notes

Laravel 9 comes with release notes, and the full list of features, you can see them on Laravel 9 release notes

Upgrade To Laravel 9

You have 2 possible ways to upgrade your application to Laravel 9

First one is to do it manually, Check The Upgrade Guide
Use Automation tools such as Laravel Shift

Conclusion

The features above are just a few ones on this new release, if you want to know more, you may refer to Laravel 9 release notes

If you are a visual learner, you may check Laravel 9 - Everything You Need to Know (In 45 Minutes)
by Jeffery way on laracasts, or 12 Minutes, What's New in Laravel 9
by Mohamed Said.

This all what I want to say today, Have a happy Upgrade 🥳

Scaffold Multiple Files in one command with laracommand package.

Oussama — Tue, 08 Feb 2022 09:06:42 +0000

Introduction

There are many CLI tools nowadays built for Laravel, and this is one of those.

laracommand is a CLI tool to save you time, and gives you the power to scaffold all of your models, controllers, commands in one go.

Prerequisite

You need to know the following:

Need to know PHP
Basics on Laravel & the artisan command Laravel
Basics on composer [Composer][https://getcomposer.org]

Why this package?

At the beginning of any project, we need to create many files (models, controllers, views, factories...) Thanks to Laravel artisan commands, to make this happens without any efforts counts but, imagine you want to create 10 models, you need to run the command php artisan make:model 10 times right?
With this tool, no need for that! All what you need to do is run the command and name as many as models you want, and it will create them all for you.

Installation

You can install the package via composer:

composer require coderflexx/laracommand --dev

The --dev option is to install it in development purposes.

Usage

Use the commands like using laravel make commands

make model command

php artisan laracommand:make-model FirstModel SecondModel

You can generate as many as you want of models, and you can add options like make:model command

Check out the docs for more, just replace make:model with laracommand:make-model

If you want to create the model and controller for example, you need to do the following:

php artisan laracommand:make-model FirstModel SecondModel ThirdModel --controller

if pass the flag -c instead of --controller

Note

This package is for development use only, you are free to disable/remove it once you are done with.

Changelog

You can follow the changes on this package by accessing the changelog or the releases

Contributing

If you want to contribute, feel free to read the CONTRIBUTING guidelines, and make your PR

Conclusion

Today we s learned about Laracommand package, and how to use it. To make our development process easier and save us time.

DEV Community: Oussama

Count Models and Get Detailed Analytics With Laravisit Package

Introduction

Prerequisite

Why this package?

Installation

Usage

Changelog

Contributing

Conclusion

Decorate Your Model Attributes Using Laravel Presenter Package

Introduction

Prerequisite

Why this package?

Installation

Usage

Model Implementation

Create New Model Presenter class

Using the Presenter Generated Class

Real Life Example

Adding Another Presenter Type:

Changelog

Contributing

Conclusion

Laravel 9 released, See What's new.

Introduction

Prerequisite

Releases Schedule

Laravel 9 new features

New route:list look

Route Groups

Forced Scoped Bindings

Blade Template Inline Rendering

Optional Bootstrap 5 Pagination Views

Brand new Ignition Page

str() helper function

to_route() helper function

Enum Attribute Casting

Brand-new Accessors & Mutators (Simplified)

Laravel 9 Release Notes

Upgrade To Laravel 9

Conclusion

Scaffold Multiple Files in one command with laracommand package.

Introduction

Prerequisite

Why this package?

Installation

Usage

Note

Changelog

Contributing

Conclusion

Using the `Presenter` Generated Class