DEV Community: Adeyemi Adeshina

Laravel API Error Exception Handling Methodologies.

Adeyemi Adeshina — Sun, 23 Jul 2023 16:23:59 +0000

Laravel is one of the most used backend frameworks in building modern APIs for applications. When building APIs or writing codes (either simple or complex algorithms), no developer can escape from encountering errors. In this short article, I'll be sharing a simple tips on how to handle these errors.

These are some of the reasons why you need to learn error handling:

To avoid unnecessary termination of your program.
To avoid security threat on your application.
Proper communication to the end user or the API tester of your application. etc

Here are common errors you will likely encounter when building your APIs:

MethodNotAllowedHttpException
NotFoundHttpException
BadMethodCallException

In Laravel, all exceptions are properly handled in the:
\app\Exceptions\Handler.php.

After Locating the path, you will find the render method, inside the method, all exceptions should be written there.

1.MethodNotAllowedHttpException usually occurs when you're trying to POST to a GET route or you're trying to GET from a POST route or similar

Popular error:

Solution:



use Symfony\Component\HttpKernel\Exception\MethodNotAllowedHttpException;
public function render($request, Throwable $exception){
        if ($exception instanceof MethodNotAllowedHttpException)
        {
            return response()->json( [
                'success' => 0,
                'message' => 'This Method is not allowed for the 
                   requested route',
                'status' => '405',
            ], 405 );
        }
}

2.NotFoundHttpException in Laravel always means that it was not able to find a router for a particular URL

Popular error:

Solution:



use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
public function render($request, Throwable $exception)
     if ($exception instanceof NotFoundHttpException) {
            return response()->json( [
                'success' => 0,
                'message' => 'This Route is not found',
                'status' => '404',
            ], 404 );
        }
}

3.BadMethodCallException is thrown if a callback refers to an undefined method or if some arguments are missing.
Solution:



public function render($request, Throwable $exception){
      if ($exception instanceof \BadMethodCallException) {
            return response()->json( [
                'success' => 0,
                'message' => 'Bad Method Called',
                'status' => '404',
            ], 404 );
        }
}

NOTE: There should not be multiple render methods. Just one! You put all your exceptions inside one render method

I hope this short article has been helpful to you? Kindly add more exceptions if you know of any other ones.

Laravel Custom Login Validation with Ajax

Adeyemi Adeshina — Sat, 08 Jan 2022 16:17:29 +0000

Laravel is arguably the most used and popular PHP Framework for Web Artisans.

Laravel has its own in-built functionality for Auth (User Registration and Login). If you think you feel satisfied with the in-built functionality, you can make use of it and your application will work well. But, if you want to go further to have your own custom Auth function, this article is for you. Let's get started!

In this article, I will be showing you how you can write custom login form validation and authentication without reloading the browser.

STEP 1: Create Users
I want to assume you already have users created in your users database table.

STEP 2: Create Login Page
This our our short code for our login page view



<body>
<div class="col-lg-4 col-md-4">
   <form action="{{ route('login') }}" method="POST"  id="login_form" 
   class="request-form ">
    @csrf
   <h2>Login</h2>
   <div id="show_error" style="color: red"> </div>

   <div class="form-group mr-2">
      <label for="" class="label">Email</label>
      <input type="email" name="email" class="form-control" >
      <span class="text-danger error-text email_error" 
       style="color: red"></span>
   </div>

   <div class="form-group mr-2">
      <label for="" class="label">Password</label>
      <input type="password" name="password" class="form-control" 
      >
      <span class="text-danger error-text password_error" 
      style="color: red"></span>
   </div>

   <div class="form-group">
   <input type="submit" value="Login" class="btn  py-3 px-4" 
   style="background-color: #5f76e8; color:#ffffff">
   </div>
  </form>
</div>
//add javascript with ajax here
<script src="[place you jquery source here...]"></script>
<script>
        $("#login_form").submit(function(e){
         e.preventDefault();

        var all = $(this).serialize();

        $.ajax({
            url:  $(this).attr('action'),
            type: "POST",
            data: all,
            beforeSend:function(){
                $(document).find('span.error-text').text('');
            },
            //validate form with ajax. This will be communicating 
              with your LoginController
            success: function(data){
                if (data.status==0) {
                    $.each(data.error, function(prefix, val){
                        $('span.'+prefix+'_error').text(val[0]);
                    });
                }
               // redirect the user to [another page] if the 
                   login cred are correct. Remember this is 
                   communicating with the LoginController which we 
                   are yet to create
                if(data == 1){
                    window.location.replace(
                     '{{route("dashboard.index")}}'
                    );
                }else if(data == 2){
                 // Show the user authentication error if the 
                   login cred are invalid. Remember this is 
                   communicating with the LoginController which we 
                   are yet to create
                    $("#show_error").hide().html("Invalid login 
                       details");
                }

            }
            })

        });


    </script>
</body>

Login View Sample : login.blade.php

NOTE: You can customize this to your desire

STEP 3: Create LoginController
Open your command prompt interface, cd to your project
directory and paste the below command there
php artisan make:controller LoginController

 namespace App\Http\Controllers;
 use Illuminate\Support\Facades\Auth;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Session;
 use Illuminate\Support\Facades\Validator;
   class LoginController extends Controller{
      public function login(Request $request){
        $validator = Validator::make($request->all(), [
        'email' =>    'required',
        'password' => 'required',
      ]);
       // validate all requests and it sends output to your 
          login.blade.php

       if(!$validator->passes()){
          return response()->json([
             'status'=>0, 
             'error'=>$validator->errors()->toArray()
          ]);
        }

       $user_cred = $request->only('email', 'password');
        if (Auth::attempt($user_cred)) {

             //if user is logged in and the role is user
            if(Auth()->user()->role=='user'){  
               return response()->json([ [1] ]);
            }  

        }else{
             //if user isn't logged in
                return response()->json([ [2] ]);
        }
        return redirect("/");
     }
  }

STEP 4: Modify your route:web.php
add your controller to your web.php; as the case maybe
Route::post('/login'[App\Http\Controllers\LoginController::class, 'login'])->name('/login');

Hello friends, in this article we successfully created a login form with Laravel and AJAX without reloading the browser. I hope you enjoy it.

Chatwoot: The Better Way to Talk To Your Customers

Adeyemi Adeshina — Sat, 02 Oct 2021 11:12:16 +0000

All paying and potential customers always want a swift and better way to communicate or engage with any company or business. Imagine a customer having some issues or concerns about doing your business with you and he wants to have some of his issues answered faster.

A very poor and slower conversation may lead to loosing that customer and some other ones coming in. That's why customer engagement is one of the pillars of modern businesses to success.
It's not enough to have a great product, every business must find a better way to talk to customers, and build bonds.

The Beauty of Chatwoot

By making it easier for customers to engage in ways they find valuable, you’ll strengthen their emotional investment in your brand. They will trust you more, and when they do, your business grows.

Yes, I know you have seen more than enough customer engagement platforms. I have seen them too, and I have used quite a number of them.

Chatwoot is an open source customer engagement platform created to improve and properly structure conversations around B2B and P2B.

Imagine your business having several social media engagement platforms such as Facebook, Instagram, Twitter, Whatsapp, Telegram etc. and all your customers send you messages via all these platforms. You will agree with me that managing conversations around all the platforms look so tedious, cumbersome and boring.

Rather than having to manage conversations everywhere, Chatwoot, with its beautiful and easy to use dashborad, allows you to integrate all your social media platforms including your website seamlessly within few seconds.

Chatwoot includes a live chat tool; and out-of-the-box integrations with third-party platforms such as Slack, Shopify, Stripe and chatboot tools such as Rasa and DialogFlow.

How To Begin
1. Go to the Registration page and enter your details
Register Here

2. After successful registration, you'll be redirected to your dashboard where you can integrate social media platforms and chat seamlessly. Remember to confirm your account in your registered email.

Learn more about Chatwoot

Formatting Dates in React Js with fns

Adeyemi Adeshina — Wed, 22 Sep 2021 01:19:10 +0000

If you are new to reactjs, you will agree with me that date format is quite different from that of core javascript where what is needed to do is just writing a simple date object: new Date().

However in the modern day JavaScript library which is reactjs, getting and formatting date is quite different. Though there are ways to format dates, but I will show you the simplest way you can go about it.

1 install npm date-fns in your project directory (root directory)

C:\MyProjects\react-project>npm install date-fns

2 use import { format } from 'date-fns' within your component

import { format } from 'date-fns'

3 use the new Date() object within your component

Now, after doing 2 and 3 as mentioned above, you can then make use of the Date() and format it as you wish. For example:

{format ( new Date(), 'do MMMM Y')}

This will give us the current date. Example: 22 SEPTEMBER 2021