新建動物資源檔案

先前我們提到的,需要一個 

物件(Object) 來操作,這邊我們是 動物 這個物件資源

動作(Action)有 新增、刪除、修改、查詢 簡稱CRUD

以及設定URI讓每個要串接API的開發者可以送請求

產生Model

產生一個Model,我自己是把它理解成建立一個我們要操作的物件。

例如:操作文章的動作,那我就會新建一個 Post 的Model

如果我的需求是User(使用者)的操作,那我就會建立一個 User 的Model,請執行下方指令,建立一個Animal物件。

C:\project\animal\ > php artisan make:model Animal -rmc

執行結果

後方 -rmc 的意思是,在建立Model 同時建立

  • Migration
  • Controller ( r 的意思是載入預設CRUD方法)

總共產生三個檔案

  • database/migrations/2019_08_22_201730_create_animals_table.php  (Migration)
  • app/Http/Controllers/AnimalController.php (Controller)
  • app/Animal.php (Model)

指令有加入r變數,所以打開AnimalController.php可以看到已經有很多方法寫在裡面。

另外 2019_08_22_201730_create_animals_table.php 前面的日期時間是產生檔案時自動產生的紀錄。(你的可能跟我不相同,不過沒關係!)


接下來打開 api.php 設定路由,新增下方程式碼。

小技巧 VSCode 的快捷鍵 Command + P(macOS) Ctrl + P(window) 在對話框輸入 api.php 可以快速開啟檔案。

Route::apiResource('animal', 'AnimalController');

apiResource 是 Laravel 內建的方法,可以把 URI 自動對應到 AnimalController 內相對應的方法。

可以下指令

C:\project\animal\ > php artisan route:list

查看路由如下圖所示

因為我們設定 URI 為 animal 所以會以這個字串對應到 AnimalController ,兩個不一定要一樣,但通常設定一樣。

拿路由表的其中一個解釋一下

MethodURINameActionMiddleward
GET/api/animal/{animal}anumal.showApp\Http\Controllers\AnimalController@showapi

這是一個查看單一動物資料的API。

HTTP 動詞 GET 請求 http://127.0.0.1:8000/api/animal/{animal} ,前面api前贅詞是因為我們把方法寫在 api.php 這一路的路由,{animal} 表示動物的ID,查詢ID1動物的資料 URI長得像這樣 http://127.0.0.1:8000/api/animal/1 ,並且對應到AnimalController 裡面的 show 方法。

好了我們到這裡已經順利的把一個資源基本的東西建立起來,但還有資料庫的部分以及CRUD的實際功能

資料庫規劃

需求是可以讓想認養的人可以看到浪浪資訊,所以我打算儲存下面的內容。

欄位說明格式備註
idIDbigInteger(10) unsigned
type_id動物分類int(10) unsigned
name動物的暱稱varchar(255)
birthday生日date NULL
area所在地區varchar(255) NULL
fix結紮情形tinyint(1)預設 false
description簡單敘述text NULL
personality動物個性text NULL
created_at新建時間timestamp NULL
updated_at更新時間timestamp NULL

發佈留言