この部分では、RESTインターフェイスで作業(yè)を開始します。 LaravelでREST APIを作成することはそれほど難しくありません。心に留めておく必要があるのは、Emberjsを扱っており、新しいアダプターをゼロから書きたくないということです。いつものように、この部分のソースコードをGitHubで見つけることができます。

キーテイクアウト

ember.jsの規(guī)則を使用して、laravelを使用してapiを構(gòu)築するときに互換性を確保し、開発プロセスを合理化します。

Laravelでリソースコントローラーを作成して、職人のコマンドラインツールを使用して、CRUD操作を手動で定義する必要なく、安らかなリソースを効率的に管理します。
• Laravelの特定の名前空間の下にそれらをグループ化することにより、ルートを効果的に整理し、API構(gòu)造とアクセシビリティを強(qiáng)化します。
データの取得を管理し、堅(jiān)牢なAPIエンドポイントを確保するために、コントローラーにエラー処理と応答のフォーマットを?qū)g裝してください。 LaravelのEloquentおよびAPIリソースクラスを活用して、モデルデータをJSON応答に変換し、Ember.jsのようなフロントエンドフレームワークと簡単に統(tǒng)合します。
どこから始めればいいですか？
それは難しい質(zhì)問です。 Emberには獨(dú)自のワークフローとロジックがあります。その論理を念頭に置いて休息を書き始めると、時(shí)間を節(jié)約できます。素晴らしいアーキテクチャと再利用可能なものがあります。エンバーは彼らの休憩所の建築に良い選択をしたと思います。 Emberがデータをどのように期待しているかを見てください
• ユーザーを取得したいと仮定しましょう。エンバーは次のようなことを期待しています：
ユーザーのリストを取得したい場合、Emberは次のようなJSONを期待するでしょう：

最初のものには「ユーザー」が必要ですが、2番目のユーザーには「ユーザー」が必要です。 2つ目は複數(shù)です。エンバーもそのためにいくつかのルールを入れました。

を使用して複數(shù)形を自分で指定しない場合

emberjsは仮定し、「式」を要求します。フレームワーク自體がそのようなことを提供するのは良いことですが、一方で、これらの詳細(xì)を忘れた場合、物事は制御不能になります。

エンバーでより深く冒険する前に、警告：エンバーは困難で強(qiáng)力です。時(shí)間をかけてそれがどのように機(jī)能するかを?qū)Wびましょう

{
      "user": {
        "firstName": "firstName",
        "lastName": "lastName"
      }
    }

少し物事を複雑にし、オブジェクト間に何らかの関係を置くと、たとえば、ユーザーが寫真を持っていると言います。どのようにそれを出力しますか？

{
      "users": 
      [
          {
            "firstName": "firstPersonsName",
            "lastName": "lastname"
          },
          {
            "firstName": "secondPersonName",
            "lastName": "lastName"
          }
      ]
    }

これは1対多くの関係です。ユーザーをリクエストすると、彼の寫真も引っ張られます。 Laravelですでにいくつかの関係を設(shè)定しています。必要に応じて使用して、Emberでそれらの関係を消費(fèi)することもできます。

このフレームワークがどのようにデータを望んでいるかを確認(rèn)するためにEmberから始めました。構(gòu)造の構(gòu)築方法を知っていれば簡単です。データベースからデータを検証と取得するのは簡単ですが、堅(jiān)実な休憩インターフェイスとスマートなインターフェイスを構(gòu)築することは難しい部分です。

殘りの準(zhǔn)備

何かを開発すると、モックアップが非常に役立ちます。あなたが第一人者であり、PhotoshopやGimpに対処するのが嫌いであっても、プロトタイプに適したツールがあります。私はBalsamiqを使用しましたが、私のフロントページのプロトタイプはこれでした：

それを構(gòu)築し始めましょう。 Open /App/views/index.php。これは、シングルページアプリとして機(jī)能します。このシリーズの最初の部分でこのファイルを作成しました。

{
      "user": {
        "firstName": "firstName",
        "lastName": "lastName"
      }
    }

これを説明させてください。 NAVタグはナビゲーションを擔(dān)當(dāng)します。クラスのタイトルエリアのULタグは、アプリケーションの最初のレベルにリンクするロゴとして使用されるテキストです。また、カテゴリのリストを備えたドロップダウンも追加しました。詳細(xì)を知りたい場合は、5つのドキュメントにアクセスしてください。ほとんどの場合、操作をコピー/貼り付けているだけなので、この部分について心配しないでください。 また、コンテンツ領(lǐng)域にFoundationのグリッドシステムを使用しました。これはすべての情報(bào)で満たされ、ナビゲート中に変更されます。すべての內(nèi)部更新はEmberによって処理されます。ここでは3つのテンプレートのみを構(gòu)築します。 1つはユーザー用、1つは1つの寫真用、もう1つはランディングページ用です。

すべてのコードがスクリプトタグ內(nèi)にあることに気付きましたか？ Emberは、ハンドルバーをテンプレート言語として使用します。テキスト/Xハンドルバーのタイプは、特別なタイプのスクリプトです。 Emberとハンドルバーをしばらく使用している場合は、おそらくテンプレート名を使用しました。このテンプレートはすべてのアプリケーションのコンテナとして使用されるため、このテンプレートはそれらを指定しません。名前を指定しない場合、Emberはアプリケーションテンプレートとして使用します。

リソースコントローラー

この非常にシンプルなアプリを開発したとき、REST APIを開発するときにリソースコントローラーが役立つことがわかりました。それがRESTアーキテクチャのポイントです。すべてがリソースです。すべてのリソースには、http動詞を適用できます。すべての動詞が必要なわけではありません

これは、Artisanを介してリソースコントローラーを作成する方法です。オプション-Exceptは、このコントローラーからこれら2つの方法を除外します。メソッドの作成と編集は必要ありません。作成メソッドは、そのリソースを作成するグラフィカルインターフェイスを扱います。 1ページのアプリを作成しているので、Emberの外にビューを作成するのは賢明ではありません。

カテゴリの別のリソースコントローラーを作成します。ご覧のとおり、このコントローラーでは表示とインデックスメソッドのみが利用できます。個々のカテゴリを表示し、すべてのカテゴリを取得するだけで十分だと思います。

{
      "user": {
        "firstName": "firstName",
        "lastName": "lastName"
      }
    }

別のコントローラーは畫像コントローラーです。すでにそれを持っているのに、なぜ畫像コントローラー？畫像を提供するにはエンドポイントが必要だからです。 Dropboxは畫像を保持していますが、外部からアクセスすることはできません。フォルダを公開したい場合は、支払う必要があります。それが最初の理由です。 2番目の理由は、すべてのイメージを公開したくないということです。一言で言えば、このコントローラーはDropboxから畫像をつかみ、クライアントに提供します。

{
      "users": 
      [
          {
            "firstName": "firstPersonsName",
            "lastName": "lastname"
          },
          {
            "firstName": "secondPersonName",
            "lastName": "lastName"
          }
      ]
    }

そして最後になりましたが、usercontroller：

です

Ember.Inflector.inflector.irregular('formula', 'formulae');

ルート

コントローラーができたので、それらのコントローラーを関連するルートにリンクする必要があります。 /app/routes.phpを更新しましょう。 まず、ルート::グループを使用してURLネームスペース內(nèi)にそれらをグループ化します。

{
      "user": {
        "id": 1,
        "name": "firstName",
        "lastname": "lastname,
        "photos": [1, 2, 3]
      },
    
      "photos": 
      [
          {
            "id": 1,
            "title": "Lorem Ipsum"
          },
          {
            "id": 2,
            "title": "Lorem Ipsum"
          }
      ]
    }

ここでは、名前空間であるプレフィックスを指定しました。このグループ內(nèi)にあるものはすべて、次のようにアクセスできます：

また、そのグループ內(nèi)のフィルターを指定できます。たとえば、auth :: wonebasic（ 'username'）フィルターを追加するか、このグループに追加して追加できます。他の認(rèn)証も使用できます。

<script type="text/x-handlebars">
    
        <!-- The navigation top-bar -->
        <nav  data-topbar>

            <ul >
                <li >
                    <h1><a href="#">Photo Upload</a></h1>
                </li>
            </ul>

            <section >

                <!-- Left Nav Section -->
                <ul >
                    <li >
                        <a href="#">Categories</a>
                        <ul >
                            <li><a href="#">Category1</a></li>
                            <li><a href="#">Category2</a></li>
                            <li><a href="#">Category3</a></li>
                            <li><a href="#">Category4</a></li>
                        </ul>
                    </li>
                </ul>

            </section>

            <div ></div>
            
        </nav><!-- END Navigation -->
        
        <!-- Content -->
        <div style="margin-top: 50px;">
            <!-- The content will be here -->
        </div><!-- END Content -->

    </script>

そのグループ內(nèi)に3つのコントローラーを追加します。 Photocontroller、usercontroller、およびcategorycontroller

そのグループの外にImagesControllerを追加します。このコントローラーには名前空間が必要だとは思いません。畫像は畫像であり、名前空間を與えることには意味がありません。

php artisan controller:make PhotoController --except=create,edit

最終的には、 /app/routes.phpファイルは次のようになります：

php artisan controller:make CategoryController --only=show,index

Emberの要件により、リソース名が複數(shù)形であることに注意してください。 これらのコントローラーの充填

php artisan controller:make ImagesController --only=show

今、私たちは何かを作り始めることができます。すべてのことを説明するのが非常に難しいので、私はここでの休憩についてすべてをカバーするつもりはありません。詳細(xì)を知るために、このシリーズを參照してください。寫真コントローラーから始めましょう

インデックス（）メソッドは、データベースから最新の寫真を返す必要があります。ここでは、いくつかのページネーションを行うことができますが、私は物事が複雑になりすぎてほしくありません。コメントに十分な関心がある場合は、このアプリケーションを今後の記事で更新します。

これを説明させてください。すべてをトライに挿入し、キャッチして最後にブロックしました。何か問題が発生した場合は、ステータスコードを使用して別のJSONを返してください。

これはデータベースから9枚の寫真をつかみます。次に、すべての寫真を撮って、後でJSON形式に変換されるフォーマットされた配列で表示します。

すべてがうまくいった場合、または例外が雄弁さによってスローされない場合、これは正しい出力を表示します。特定のステータスコードを表示する場合は、雄弁でスローできるすべての例外をキャッチし、適切なステータスコードを表示します。

今すぐShow（）メソッドを記入しましょう。繰り返しますが、特定のIDを使用して寫真に関するすべての情報(bào)を取得したいと考えています。

php artisan controller:make UserController --only=show,index

獨(dú)自のアプリを構(gòu)築するときは、ユーザー入力に検証を追加することを忘れないでください。

usercontrollerのロジックはほぼ同じです。今回は、ユーザーモデルをリクエストします。

{
      "user": {
        "firstName": "firstName",
        "lastName": "lastName"
      }
    }

すべてがほぼ同じで、モデルとフィールドのみが変更されます。出力JSON。 showメソッドは次のようになります：

{
      "users": 
      [
          {
            "firstName": "firstPersonsName",
            "lastName": "lastname"
          },
          {
            "firstName": "secondPersonName",
            "lastName": "lastName"
          }
      ]
    }

この関數(shù)は、指定されたIDを持つユーザーを取得します

私たちが扱っている最後のコントローラーは、ImagesControllerです。ロジックは、ファイルシステムから畫像をつかんでそれらを提供するのと同じくらい簡単です。ファイルを保存し、ローカルファイルシステムまたはサーバーファイルシステムで取得する場合は簡単です。殘念ながら、ファイルをHerokuに保存することはできないため、Dropboxを使用して、このエンドポイントからそれらのファイルを提供します。

ドロップボックスクライアントとフライシステムアダプターをインポートします。私たちの環(huán)境がローカルの場合、ローカルアダプターを使用してフライシステムを使用します。環(huán)境が生産されている場合は、Dropboxアダプターを使用してください。フライシステムクラスをこのコントローラー內(nèi)のプライベート変數(shù)に割り當(dāng)てます。

showメソッドはそのファイルにサービスを提供し、Destroyメソッドはファイルシステムからそのファイルを削除します。このライブラリを使用することにより、私たちはアプリにレベルの抽象化を入れました。

Ember.Inflector.inflector.irregular('formula', 'formulae');

Destroy（）関數(shù)は非常に単純です。削除メソッドを使用して、削除するファイルの名前を渡すことにより、そのファイルを選択してください。ファイルが見つからない場合は、404を返します。

最終的には、ImageControllerは次のようになります：

{
      "user": {
        "id": 1,
        "name": "firstName",
        "lastname": "lastname,
        "photos": [1, 2, 3]
      },
    
      "photos": 
      [
          {
            "id": 1,
            "title": "Lorem Ipsum"
          },
          {
            "id": 2,
            "title": "Lorem Ipsum"
          }
      ]
    }

提供した形式はHTMLです。わかりました、それは少し奇妙です。 HTMLではなく畫像を提供したかったのです。ただし、ブラウザはファイル形式を探し、そのファイルの使用方法を認(rèn)識しているため、それは問題ではありません。

<script type="text/x-handlebars">
    
        <!-- The navigation top-bar -->
        <nav  data-topbar>

            <ul >
                <li >
                    <h1><a href="#">Photo Upload</a></h1>
                </li>
            </ul>

            <section >

                <!-- Left Nav Section -->
                <ul >
                    <li >
                        <a href="#">Categories</a>
                        <ul >
                            <li><a href="#">Category1</a></li>
                            <li><a href="#">Category2</a></li>
                            <li><a href="#">Category3</a></li>
                            <li><a href="#">Category4</a></li>
                        </ul>
                    </li>
                </ul>

            </section>

            <div ></div>
            
        </nav><!-- END Navigation -->
        
        <!-- Content -->
        <div style="margin-top: 50px;">
            <!-- The content will be here -->
        </div><!-- END Content -->

    </script>

先に進(jìn)み、CategoryControllerを作成してみてください。私はあなたのための運(yùn)動としてそれを除外しました。

APIのテスト

php artisan controller:make PhotoController --except=create,edit

私は認(rèn)めなければなりません、私はphpstormに戀をしています、そして、殘りのAPIをテストするために、私はRESTクライアントと呼ばれるツールを使用します。これは、テストを簡素化するグラフィカルインターフェイスです。必要に応じて、端末からカールを使用することもできます。いくつかのテストを行いましょう：

そしてこれが返されたものです：

php artisan controller:make CategoryController --only=show,index

phpstormのレストクライアントを使用すると、JSONで同じ結(jié)果が得られます。

そして、結(jié)果をより良い形式で確認(rèn)したい場合は、ツールの左側(cè)にあるJSアイコンを押すだけで、RESTクライアントはより良い表現(xiàn)を與えてくれます。

削除や投稿など、他の動詞をテストすることもできます。先に進(jìn)んで、できる限りテストしてください。テストに使用できる他のクライアントがあります。レストコンソールと郵便配達(dá)員はそのうちの2つです。 1つ目はChromeでのみ利用でき、2番目のChrome、PostmanはChromeとFirefoxの両方で利用できます。郵便配達(dá)員はよりシンプルでユーザーフレンドリーなようです。先に進(jìn)んで、試してみてください。

結(jié)論

Laravelは、リソースコントローラーを使用してREST APIを構(gòu)築するための作業(yè)を簡素化します。 Emberコンベンションを使用して、インターフェイスをどのように構(gòu)築するかを確認(rèn)しました。 Emberは優(yōu)れたインターフェイスを選択しており、そのロジックに固執(zhí)することで、他のプラットフォームのコードを簡単に再利用できます。

この部分では、概念にもっと焦點(diǎn)を合わせており、あまりコーディングをしませんでした。すべてのメソッドを埋めて検証を追加すると、この投稿が既に長く、長いシリーズになったときに、この投稿を不必要に拡張しました。開発するときは、常に入力を検証する必要があります。それを忘れないでください、そしてテスト、テスト、テスト。テストはあなたの親友でなければなりません。

このシリーズの最終記事では、完全に機(jī)能するライブアプリケーションにすべてをまとめます。

Laravelを使用した休憩リソースの構(gòu)築に関するよくある質(zhì)問

Laravelでリソースコントローラーを作成するにはどうすればよいですか？

Laravel Eloquentリソースの目的は何ですか？ Eloquent ORMモデルとモデルコレクションはJSON形式になります。これは、APIを構(gòu)築するときに特に役立ちます。これにより、API応答で送信するデータの正確な形狀と形式を制御できます。データ出力を制御するための一貫した管理可能な方法を提供します。

laravel APIリソースを使用するにはどうすればよいですか？

Laravel APIリソースを使用するには、最初にリソースクラスを作成する必要があります。これは、Artisan Command PHP Artisan Make：Resource Resourcenameを使用して実行できます。リソースクラスが作成されたら、リソースのToArrayメソッドの変換を定義できます。ルートからリソースを返すには、リソースクラスの新しいインスタンスを返すだけで、変換するデータを渡します。 ??>リソースクラスのToArrayメソッドを変更することにより、Laravelリソースによって返されたデータをカスタマイズできます。 ToArrayメソッドは、雄弁なモデル屬性をAPI応答屬性にマッピングする場合です。必要に応じて屬性を追加、削除、または変更できますLaravelのリソースとコレクションの違いは何ですか？

laravelのリソースクラスは、JSON構(gòu)造に変換する必要がある?yún)g一のモデルを表し、リソースコレクションクラスはコレクションを表します。リソースの。リソースコレクションは、モデルのアレイまたはコレクションをJSONに変換するために使用されます。

Laravelでリソースコレクションを作成するにはどうすればよいですか？ Artisan Command Php Artisan Make：Resource ResourcenAmeCollection - Collection。これにより、コレクションの変換を定義できるリソースコレクションクラスが作成されます。

laravelのルートからリソースコレクションを返すにはどうすればよいですか？ Laravelでは、リソースコレクションクラスの新しいインスタンスを返すだけで、変換するモデルのコレクションを渡します。はい、あなたLaravelのリソース応答にメタデータを追加できます。これは、リソースのメソッドを使用してAを定義することで実行できます。 withメソッドは、応答に含めたいメタデータの配列を返す必要があります。

laravelリソースで條件付き屬性を処理するにはどうすればよいですか？リソース応答に屬性を條件付きで追加します。メソッドが2つの引數(shù)を受け入れるとき：屬性を含めるべきかどうかを決定する條件と、條件が真である場合の屬性の値。はい、Laravelリソースは、Laravelの組み込みのページネーションと完全に機(jī)能します。 Laravel Eloquentクエリをページングすると、Laravelは、ページネーションリンクとともにパジネート結(jié)果を含むJSON応答を自動的に返します。ページングされた応答をカスタマイズする場合は、リソースコレクションを使用できます。

以上がLaravelでRESTリソースを構(gòu)築しますの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國語 Web サイトの他の関連記事を參照してください。