在這一部分中，我們將開始使用REST接口。在Laravel上創(chuàng)建REST API并不是很困難。我們需要記住的是，我們正在與Emberjs打交道，并且我們不想從頭開始寫一個(gè)新的適配器。像往常一樣，您可以在github上找到此部分的源代碼。

>

鑰匙要點(diǎn)

>使用ember.js約定在用laravel構(gòu)建REST API時(shí)確保兼容并簡(jiǎn)化開發(fā)過程。
• >使用工匠命令行工具在Laravel中創(chuàng)建資源控制器，以有效地管理靜止資源，而無需手動(dòng)定義CRUD操作。
>通過在Laravel中的特定名稱空間中分組，增強(qiáng)API結(jié)構(gòu)和可訪問性，可以有效地組織路線。>
• >在控制器中實(shí)現(xiàn)錯(cuò)誤處理和響應(yīng)格式以管理數(shù)據(jù)檢索并確保強(qiáng)大的API端點(diǎn)。
• >利用Laravel的雄辯和API資源類別將模型數(shù)據(jù)轉(zhuǎn)換為JSON響應(yīng)，從而促進(jìn)了與Ember.js等前端框架的輕松集成。
• 從哪里開始？
• 這是一個(gè)很難的問題。 Ember擁有自己的工作流程和邏輯。如果我們開始牢記這種邏輯來寫下我們的休息，我們將節(jié)省一些時(shí)間，我們將擁有一個(gè)不錯(cuò)的體系結(jié)構(gòu)和可重復(fù)使用的東西。我認(rèn)為Ember在其休息建筑上做出了不錯(cuò)的選擇?？纯碋mber如何期望數(shù)據(jù)。
>

>假設(shè)我們要檢索用戶。 Ember期望這樣的事情：

如果我們想檢索用戶列表，Ember會(huì)期望這樣的JSON：>

第一個(gè)需要“用戶”，但是第二個(gè)需要“用戶”。第二個(gè)是復(fù)數(shù)。 Ember也為此規(guī)定了一些規(guī)則。如果您沒有通過以下方式自己指定復(fù)數(shù)

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

emberjs將做出假設(shè)并要求“公式”。有時(shí)候，框架本身提供了這樣的東西很高興，但是另一方面，如果您忘記了這些細(xì)節(jié)，事情可能會(huì)失控。

在與Ember更深入的風(fēng)險(xiǎn)之前，警告：Ember是困難而強(qiáng)大的?；c(diǎn)時(shí)間學(xué)習(xí)它的工作原理。

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

如果我們使事情有些復(fù)雜并在對(duì)象之間放置一些關(guān)系，例如，我們說用戶有一些照片。我們將如何輸出？

>

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

這是一個(gè)一對(duì)多的關(guān)系。如果我們要求用戶，他的照片也將被拉。我們已經(jīng)在拉拉維爾（Laravel）建立了一些關(guān)系，如果您想要并在Ember上消耗這些關(guān)系，可以使用它們。

>

>我從Ember開始，看看該框架如何想要數(shù)據(jù)。如果您知道如何構(gòu)建結(jié)構(gòu)，那就容易了。驗(yàn)證和從數(shù)據(jù)庫中獲取數(shù)據(jù)很容易，但是建立一個(gè)可靠的REST接口和一個(gè)智能的界面，這是困難的部分。

準(zhǔn)備其余的

當(dāng)您開發(fā)某些東西時(shí)，模型可能會(huì)非常有幫助。即使您是一名大師程序員，并且討厭處理Photoshop或GIMP，也有很好的原型工具。我使用了balsamiq，而我的頭版原型是：

>

讓我們開始構(gòu)建它。 Open/App/views/index.php。這是我們的單頁應(yīng)用程序。我們?cè)诒鞠盗械牡谝徊糠种袆?chuàng)建了此文件。

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

允許我解釋這一點(diǎn)。 NAV標(biāo)簽負(fù)責(zé)導(dǎo)航。帶有類標(biāo)題區(qū)域的UL標(biāo)簽是文本，該文本用作徽標(biāo)，該徽標(biāo)鏈接到應(yīng)用程序的第一個(gè)級(jí)別。我還添加了一個(gè)帶有類別列表的下拉菜單。如果您想了解更多信息，請(qǐng)前往基礎(chǔ)5個(gè)文檔。在大多數(shù)情況下，它只是復(fù)制/粘貼操作，所以不必?fù)?dān)心此部分。>

>另外，我在內(nèi)容區(qū)域使用了Foundation的網(wǎng)格系統(tǒng)。這將充滿所有信息，并在導(dǎo)航時(shí)進(jìn)行更改。所有內(nèi)部更新將由Ember處理。我們將在這里僅構(gòu)建3個(gè)模板。一個(gè)用于用戶，一張用于一張照片，一張用于著陸頁。

>

您是否注意到我們所有的代碼都在腳本標(biāo)簽中？ Ember使用車把作為模板語言。文本/X Handlebars的類型是一種特殊的腳本類型。如果您使用了Ember和車把一段時(shí)間，則可能使用模板名稱。我沒有在此中指定它們，因?yàn)榇四０鍖⒂米魉袘?yīng)用程序的容器。如果您沒有指定名稱，Ember將其用作應(yīng)用程序模板。

資源控制器

>我開發(fā)了這個(gè)非常簡(jiǎn)單的應(yīng)用程序時(shí)，我發(fā)現(xiàn)在開發(fā)REST API時(shí)，資源控制器會(huì)派上用場(chǎng)。這就是其余體系結(jié)構(gòu)的重點(diǎn) - 一切都是資源。所有資源都可以應(yīng)用HTTP動(dòng)詞：獲取，發(fā)布，刪除，put（更新）。并非所有動(dòng)詞都需要。

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

這就是我們通過工匠創(chuàng)建資源控制器的方式。該選項(xiàng) - 除了從該控制器中刪除這兩種方法。我們不需要?jiǎng)?chuàng)建和編輯方法。創(chuàng)建方法處理創(chuàng)建該資源的圖形接口。當(dāng)我們制作一個(gè)頁應(yīng)用程序時(shí)，在ember之外創(chuàng)建視圖是不明智的。

>

>為類別創(chuàng)建另一個(gè)資源控制器。如您所見，僅在此控制器中提供顯示和索引方法。我認(rèn)為顯示單個(gè)類別并檢索所有類別就足夠了。

>

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

>另一個(gè)控制器是圖像控制器。為什么如果我們已經(jīng)有一個(gè)圖像控制器？因?yàn)槲覀冃枰粋€(gè)終點(diǎn)來提供圖像。 Dropbox擁有我們的圖像，但我們無法從外部訪問它們。如果您想公開文件夾，則必須付款。那是第一個(gè)原因。第二個(gè)原因是我不希望每個(gè)圖像都公開。簡(jiǎn)而言之，該控制器將從Dropbox中獲取圖像并將其提供給客戶端。

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

，最后但并非最不重要的是usercontroller：

>

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

路線

>現(xiàn)在我們擁有控制器，我們需要將這些控制器與其相關(guān)路線聯(lián)系起來。讓我們更新 /app/routes.php。 首先，使用Route :: group。

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

>在這里，我們指定了一個(gè)前綴，即名稱空間?？梢赃@樣訪問此組內(nèi)部的所有內(nèi)容：

>

<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)指定過濾器。例如，您可以添加一個(gè)auth :: Anterbasic（'用戶名'）過濾或創(chuàng)建一個(gè)并將其添加到該組中。您也可以使用其他身份驗(yàn)證。

>

>在該組內(nèi)添加三個(gè)控制器。 PhotoController，UserController和categoryController。

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

>在該組之外添加ImageScontroller。我認(rèn)為該控制器不需要一個(gè)名稱空間 - 圖像是圖像，給它們提供一個(gè)名稱空間是沒有意義的。

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

最后， /app/routes.php文件應(yīng)該看起來像這樣：

>

php artisan controller:make ImagesController --only=show

請(qǐng)注意，由于Ember的要求，資源名稱是復(fù)數(shù)的。

填充這些控制器

>現(xiàn)在我們可以開始構(gòu)建一些東西。我不會(huì)在這里介紹所有的休息，因?yàn)楹茈y解釋所有事情 - 要更深入地了解更多內(nèi)容，請(qǐng)參閱本系列。讓我們從照相控制器開始。

index（）方法應(yīng)返回?cái)?shù)據(jù)庫中的最新照片。在這里，我們可以做一些分頁，但我不希望事情變得太復(fù)雜。如果對(duì)評(píng)論有足夠的興趣，我們將在以后的文章中更新此應(yīng)用程序。

>讓我解釋一下。我將所有內(nèi)容插入了嘗試，捕捉并最終阻止。如果出現(xiàn)問題，請(qǐng)返回帶有狀態(tài)代碼的其他JSON。

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

>從數(shù)據(jù)庫中獲取9張照片。然后，拍攝每張照片，并以格式化的數(shù)組顯示，該數(shù)組將在以后轉(zhuǎn)換為JSON格式。

<span>Route<span>::</span>group(array('prefix' => 'api/v1'), function()
</span>    <span>{
</span>        
    
    <span>});</span>

如果一切順利，或者雄辯沒有拋棄異常，則會(huì)顯示正確的輸出。如果要顯示特定的狀態(tài)代碼，請(qǐng)捕獲所有可以通過雄辯拋出的例外，并顯示正確的狀態(tài)代碼。

>讓我們立即填寫show（）方法。同樣，我們想用給定的ID檢索有關(guān)照片的所有信息。

構(gòu)建自己的應(yīng)用程序時(shí)，請(qǐng)不要忘記將驗(yàn)證添加到用戶輸入中。

usercontroller的邏輯幾乎相同。這次，我們將要求用戶模型。

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

>一切幾乎相同，只有模型和字段改變。輸出JSON。表演方法看起來像這樣：

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

此功能通過給定的ID檢索用戶。

我們要處理的最后一個(gè)控制器是ImagesController。邏輯就像從文件系統(tǒng)中獲取圖像并為其服務(wù)一樣簡(jiǎn)單。當(dāng)您保存文件并使用本地文件系統(tǒng)或服務(wù)器文件系統(tǒng)檢索時(shí)，這很簡(jiǎn)單。不幸的是，您無法將文件保存到Heroku，因此您將使用Dropbox并從此端點(diǎn)提供這些文件。

導(dǎo)入Dropbox客戶端和Flysystem適配器。如果我們的環(huán)境是本地的，那么我們將與本地適配器一起使用Flysystem；如果環(huán)境正在生產(chǎn)，請(qǐng)使用Dropbox適配器。將Flysystem類分配給該控制器內(nèi)部的私人變量。

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

> Show方法將為該文件提供服務(wù)，而Dosty方法將從文件系統(tǒng)中刪除該文件。通過使用此庫，我們?cè)趹?yīng)用程序中放了一定程度的抽象。

>

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

destroy（）函數(shù)非常簡(jiǎn)單。只需使用刪除方法選擇該文件并傳遞要?jiǎng)h除的文件的名稱。如果找不到文件，請(qǐng)返回404。

>

<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>

最后，ImageController應(yīng)該看起來像這樣：

>

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

我們提供的格式是HTML。好的，這有點(diǎn)奇怪。我們想提供圖像，而不是HTML。但是，這不是問題，因?yàn)闉g覽器會(huì)尋找文件格式并識(shí)別如何使用該文件。

繼續(xù)嘗試創(chuàng)建類別controller。我把它作為適合你的練習(xí)。

測(cè)試API

>我必須承認(rèn)，我愛上了phpstorm，并且在測(cè)試REST API時(shí)，我使用了稱為REST客戶端的工具。這是一個(gè)圖形界面，簡(jiǎn)化了測(cè)試。如果需要，也可以使用終端中的卷發(fā)。讓我們進(jìn)行一些測(cè)試：

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

這就是返回的東西：

>

使用PhpStorm的REST客戶端，我在JSON中獲得了相同的結(jié)果。

>，如果我想以更好的格式查看結(jié)果，我可以簡(jiǎn)單地按JS圖標(biāo)，而剩下的客戶端給我更好的表示。

>

>您還可以測(cè)試其他動(dòng)詞，例如DELETE和POST。繼續(xù)進(jìn)行測(cè)試。您還可以使用其他客戶進(jìn)行測(cè)試：REST控制臺(tái)和Postman是其中兩個(gè)。第一個(gè)僅在Chrome上可用，第二個(gè)Postman可在Chrome和Firefox上使用。郵遞員似乎更簡(jiǎn)單，更友好。繼續(xù)嘗試。

結(jié)論

Laravel簡(jiǎn)化了使用資源控制器構(gòu)建REST API的工作。我們看到了如何通過使用Ember慣例構(gòu)建界面。 Ember選擇了一個(gè)良好的界面，并堅(jiān)持使用該邏輯，您可以輕松地在其他平臺(tái)上重復(fù)使用代碼。

在這一部分中，我更多地關(guān)注概念，并且沒有做太多的編碼。填寫所有方法并添加驗(yàn)證將不必要地?cái)U(kuò)展此帖子，而該帖子已經(jīng)足夠長(zhǎng)，并且在一個(gè)長(zhǎng)系列中。開發(fā)時(shí)，您應(yīng)始終驗(yàn)證輸入。不要忘記它，測(cè)試，測(cè)試，測(cè)試。測(cè)試應(yīng)該是您最好的朋友。

在本系列的最后一期中，我們將將它們?nèi)糠旁谝粋€(gè)功能齊全的實(shí)時(shí)應(yīng)用程序中。

常見問題有關(guān)用Laravel

建立休息資源的問題

>如何在laravel中創(chuàng)建一個(gè)資源控制器？該命令是PHP Artisan Make：Controller Controllername -Resource。將“ ControlerName”替換為要給控制器的名稱。此命令將使用用于所有必要的CRUD操作的方法創(chuàng)建一個(gè)控制器。請(qǐng)記住，控制器的名稱應(yīng)以單數(shù)形式，應(yīng)該是有效的PHP類名稱。

>我如何使用Laravel API資源？

使用Laravel API資源，您首先需要?jiǎng)?chuàng)建資源類?？梢允褂肁rtisan Command Php Artisan Make：Resource ResourceName來完成此操作。創(chuàng)建資源類后，您可以在資源的Toarray方法中定義轉(zhuǎn)換。要從路線返回資源，您只需返回資源類的新實(shí)例，傳遞要轉(zhuǎn)換的數(shù)據(jù)。

如何自定義Laravel資源返回的數(shù)據(jù)？ ??>您可以通過修改資源類中的Toarlay方法來自定義Laravel資源返回的數(shù)據(jù)。 ToArray方法是將雄辯的模型屬性映射到API響應(yīng)屬性的地方。您可以根據(jù)需要添加，刪除或更改屬性。

在Laravel中的資源和集合之間有什么區(qū)別？

在Laravel中，資源類代表一個(gè)單個(gè)模型，需要將其轉(zhuǎn)換為JSON結(jié)構(gòu)，而資源收集類代表集合資源。資源集合用于將模型或集合轉(zhuǎn)換為JSON。 Artisan Command Php Artisan Make：Resource ResourceCenameCollection-收集。這將創(chuàng)建一個(gè)資源集合類，您可以在其中定義集合的轉(zhuǎn)換。

>如何從Laravel的路由返回資源集合？在Laravel中，您只需返回資源收集類的新實(shí)例，傳遞了要轉(zhuǎn)換的模型集合。

我可以將元數(shù)據(jù)添加到Laravel中的資源響應(yīng)中嗎？是的，你可以將元數(shù)據(jù)添加到Laravel中的資源響應(yīng)中。這可以通過定義資源上的方法來完成。使用方法應(yīng)返回要在響應(yīng)中包含的元數(shù)據(jù)數(shù)組。

>我如何處理laravel資源中的條件屬性？

laravel Resources提供一種方法時(shí)，有條件地將屬性添加到資源響應(yīng)中。當(dāng)方法接受兩個(gè)參數(shù)：確定是否應(yīng)包括屬性的條件，以及屬性的值，如果條件為真。是的，Laravel Resources與Laravel的內(nèi)置分頁完美搭配。當(dāng)您分解Laravel雄辯的查詢時(shí)，Laravel將自動(dòng)返回JSON響應(yīng)，其中包括分頁結(jié)果以及分頁鏈接。如果要自定義分頁響應(yīng)，則可以使用資源集合。

>

以上是使用Laravel建立休息資源的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！