Как создать приложение Laravel на платформе JWT только для API

 public function store ( Request $request ) { $currentUser = JWTAuth : : parseToken ( ) - > authenticate ( ) ; $book = new Book ; $book - > title = $request - > get ( 'title' ) ; $book - > author_name = $request - > get ( 'author_name' ) ; $book - > pages_count = $request - > get ( 'pages_count' ) ; if ( $currentUser - > books ( ) - > save ( $book ) ) return $this - > response - > created ( ) ; else return $this - > response - > error ( 'could_not_create_book' , 500 ) ; } 

Как и раньше, мы получаем текущего пользователя с JWTAuth метода parseToken()->authenticate() , parseToken()->authenticate() . Затем мы создаем наш экземпляр и сохраняем связь с помощью метода save .

Если все пойдет правильно, ответ Created 201 будет возвращен. В противном случае клиент получит пользовательскую ошибку 500 . Как мы видим, речь идет не только о теле: заголовки также будут соответствующим образом настроены для соответствия стандартам RESTful.

Давайте сделаем несколько тестов, прежде чем закончить наш контроллер. Добавьте следующий код в api_routes.php :

 $api - > group ( [ 'middleware' = > 'api.auth' ] , function ( $api ) { $api - > post ( 'book/store' , 'App\Api\V1\Controllers\BookController@store' ) ; $api - > get ( 'book' , 'App\Api\V1\Controllers\BookController@index' ) ; } ) ; 

У нас есть оба маршрута сейчас! Вернемся к нашему HTTP-клиенту и снова войдем в систему. С нашим новым токеном давайте сделаем несколько запросов на сохранение новой книги и сразу же получим их список.

Мы можем передать токен двумя способами: передать его в виде простого параметра запроса или в заголовке с этим конкретным элементом: Authorization: Bearer {token_goes_here} .

Тем не менее, вот пример запроса store и последующего index .

… а потом …

Оно работает!

Мы можем закончить работу, реализовав три оставшихся метода: show , update и destroy .

Вот они!

 . . . public function show ( $id ) { $currentUser = JWTAuth : : parseToken ( ) - > authenticate ( ) ; $book = $currentUser - > books ( ) - > find ( $id ) ; if ( ! $book ) throw new NotFoundHttpException ; return $book ; } public function update ( Request $request , $id ) { $currentUser = JWTAuth : : parseToken ( ) - > authenticate ( ) ; $book = $currentUser - > books ( ) - > find ( $id ) ; if ( ! $book ) throw new NotFoundHttpException ; $book - > fill ( $request - > all ( ) ) ; if ( $book - > save ( ) ) return $this - > response - > noContent ( ) ; else return $this - > response - > error ( 'could_not_update_book' , 500 ) ; } public function destroy ( $id ) { $currentUser = JWTAuth : : parseToken ( ) - > authenticate ( ) ; $book = $currentUser - > books ( ) - > find ( $id ) ; if ( ! $book ) throw new NotFoundHttpException ; if ( $book - > delete ( ) ) return $this - > response - > noContent ( ) ; else return $this - > response - > error ( 'could_not_delete_book' , 500 ) ; } . . . 

Мы продолжали использовать $currentUser как неявную «проверку безопасности». В реальных случаях вы должны создать что-то более надежное.

Также возможно выдать некоторые исключения Symfony. API автоматически распознает их и закодирует в правильном формате вывода. Вы можете найти полный список поддерживаемых исключений здесь .

При show , update и destroy мы использовали NotFoundHttpException чтобы сообщить клиенту, что мы не нашли определенный ресурс.

Теперь все, что нам нужно сделать, это добавить последние три новых маршрута в файл api_routes.php .

 $api - > group ( [ 'middleware' = > 'api.auth' ] , function ( $api ) { $api - > get ( 'books' , 'App\Api\V1\Controllers\BookController@index' ) ; $api - > get ( 'books/{id}' , 'App\Api\V1\Controllers\BookController@show' ) ; $api - > post ( 'books' , 'App\Api\V1\Controllers\BookController@store' ) ; $api - > put ( 'books/{id}' , 'App\Api\V1\Controllers\BookController@update' ) ; $api - > delete ( 'books/{id}' , 'App\Api\V1\Controllers\BookController@destroy' ) ; } ) ; 

Laravel (и Dingo) имеет метод ярлыка resource() который мы можем использовать, чтобы связать все маршруты, которые мы только что видели, с помощью одной инструкции.

 $api - > resource ( 'books' , 'App\Api\V1\Controllers\BookController' ) ; 

Выберите подход, который вам нравится больше всего.

Контроллер завершен. Вот оно в полном объеме !

Примечание: мы могли бы наткнуться на некоторые проблемы, используя глаголы PUT и DELETE с некоторыми данными тела. Если тело всегда пустое , попробуйте использовать x-www-form-urlencoded вместо form-data . Это должно решить проблему.

Серверная часть готова!

Вывод

В этой части мы сосредоточились на серверной части и использовали довольно стабильный и простой в использовании шаблон для построения нашего API и процесса аутентификации + регистрации. Так вот, наше приложение уже дружественное к клиенту. Соедините приложение для iOS или Android или даже одну из множества платформ JavaScript, и вы с легкостью сможете использовать содержимое нашего приложения. Именно на это мы и обратим внимание во второй части — создании приложения Angular для этого бэкэнда с нуля! Будьте на связи!