feat: Added Tip 4 Catch As Much As Possible in Validation

* Tip 5 Generally Avoid Empty 500 Server Error with Try-Catch

Author: ahmadhuss

app/Http/Controllers/Api/CategoryController.php

@@ -6,22 +6,25 @@
 use App\Http\Requests\StoreCategoryRequest;
 use App\Http\Resources\CategoryResource;
 use App\Models\Category;
+use Exception;
 use Illuminate\Http\Request;
 use Illuminate\Http\Resources\Json\ResourceResponse;
 
 class CategoryController extends Controller
 {
-    public function index(){
-       //  return Category::orderBy('id')->get(); // Laravel will return as JSON format.
-      // We only want id, name filed in the response.
-       // $categories = Category::select('id','name')->get(); This is efficient approach.
-       // But we are already defined our toArray response
+    public function index()
+    {
+        //  return Category::orderBy('id')->get(); // Laravel will return as JSON format.
+        // We only want id, name filed in the response.
+        // $categories = Category::select('id','name')->get(); This is efficient approach.
+        // But we are already defined our toArray response
         $categories = Category::all();
         return CategoryResource::collection($categories); // Now we are returning resource collection
     }
 
     // Route model binding
-    public function show(Category $category){
+    public function show(Category $category)
+    {
         // return $category; // It will return category as a JSON response object and it is the magic of Laravel
 
         // It is difficult to return only id and name with the Route model binding
@@ -33,9 +36,15 @@ public function show(Category $category){
     }
 
     // Post store
-    public function store(StoreCategoryRequest $request) {
+    public function store(StoreCategoryRequest $request)
+    {
+        try {
             $category = Category::create($request->all());
-            return new CategoryResource($category);
+            // 201 means Created Successfully
+            return (new CategoryResource($category))->response()->setStatusCode(201);
+        } catch (Exception $exception) { // Anything that went wrong
+            abort(500, 'Could not create category');
+        }
     }
 
 

routes/api.php

@@ -68,3 +68,16 @@
  * in render() method:
  */
 
+/**
+ * Tip 4. Catch As Much As Possible in Validation
+ * that consumer posts invalid data, and then stuff breaks.
+ * If we don’t put extra effort in catching bad data, then API
+ * will pass the back-end validation and throw just simple “Server error”
+ * without any details (which actually would mean DB query error).
+ *
+ * Let’s look at this example – we have a store() method in Controller and StoreFormRequest.
+ *
+ *
+ * Tip 5. Generally Avoid Empty 500 Server Error with Try-Catch
+ */
+