如何使用PHP和Unsplash API進行圖像搜索

隨著網路的發展，圖像已成為數位時代最受歡迎的媒體形式之一。而對於Web開發人員來說，實現基於圖像的功能或美化頁面，圖像的搜尋和使用已經成為web專案開發中不可避免的事情。而Unsplash是其中最受歡迎的免費照片和圖像素材庫之一。在本篇文章中，我們將介紹如何使用PHP和Unsplash API進行圖像搜尋。

1. 註冊Unsplash API金鑰

首先，您需要註冊Unsplash API金鑰。註冊過程非常簡單，只要開啟Unsplash API官網，填寫相關訊息，就可以取得API金鑰。註冊時，需要填寫您的個人資訊和項目詳情。一旦註冊成功，您將收到一個API金鑰。請記住它，因為您需要在後面的步驟中使用它。

2. 引入Unsplash API

在專案中引入Unsplash API，可以透過官方提供的Javascript、PHP或Python庫的方式引入。在這裡，我們選擇透過PHP版本的函式庫進行示範。

可以透過composer指令或直接在專案中下載原始程式碼的方式引入Unsplash API。如果您使用Composer，可以使用以下命令：

composer require unsplash/unsplash

如果您想要直接引入原始程式碼，您可以下載原始程式碼並解壓縮到您的專案根目錄下。

3. 建立Unsplash連線

在您的PHP檔案中，使用引進的Unsplash函式庫，建立一個新的Unsplash連線。使用以下程式碼：

use UnsplashUnsplash;

$accessKey = 'YOUR_ACCESS_KEY';

$unsplash = new Unsplash([
    'accessKey' => $accessKey,
]);

這裡，需要填寫在註冊Unsplash API時取得的API金鑰。透過這個範例程式碼，我們使用Unsplash庫創建了一個與Unsplash伺服器的連接。

4. 設定搜尋參數

接下來，使用Unsplash API，可以設定任意數量的搜尋參數，以在Unsplash庫中搜尋不同的圖片。這裡，我們將設定一個搜尋參數，透過關鍵字搜尋與旅遊相關的圖像。使用以下程式碼：

$keyword = 'travel';
$resultsPerPage = 20;

$searchParams = [
    'query' => $keyword,
    'per_page' => $resultsPerPage,
];

這裡，我們設定變數$keyword為'travel'，代表我們需要透過這個關鍵字進行搜尋。並且，我們也設定了一個變數$resultsPerPage為20，這代表我們希望從每個搜尋結果中取得20張圖片。在搜尋參數設定完成後，一起傳遞到搜尋函數中進行搜尋。

5. 進行圖片搜尋

使用設定好的搜尋參數，在Unsplash API中搜尋圖片。使用Unsplash庫提供的searchPhotos函數進行搜索，如下所示：

$searchResults = $unsplash->searchPhotos($searchParams);

現在，我們已經成功地搜尋了與旅遊相關的圖像。我們還需要提取這些圖像的信息，並將它們顯示在網頁上。

6. 顯示搜尋結果

在進行圖像搜尋後，需要將搜尋結果在瀏覽器中顯示出來。使用以下程式碼，提前每個圖像的信息，並將它們放在HTML頁面中：

foreach ($searchResults->getResults() as $photo) {
    $imageUrl = $photo->getUrls()['small'];
    $photoDescription = $photo->getDescription();
    $photoCredit = $photo->getUser()['name'];

    echo '<div class="image-container">';
    echo '<img src="'.$imageUrl.'" alt="'.$photoDescription.'">';
    echo '<div class="photo-credit">'.$photoCredit.'</div>';
    echo '</div>';    
}

在該程式碼區塊中，我們將提取每個影像的URL和Description。同時，也將擷取每個影像拍攝者的名稱（在Unsplash庫中稱為使用者）。然後，將這些資訊放入HTML頁面中，並將每個影像顯示在自訂的HTML div中。

7. 完整的PHP文件範例

最後，將上述所有步驟組合在一起，產生一個完整的PHP文件，如下所示：

 $accessKey,
]);

$keyword = 'travel';
$resultsPerPage = 20;

$searchParams = [
    'query' => $keyword,
    'per_page' => $resultsPerPage,
];

$searchResults = $unsplash->searchPhotos($searchParams);
?>




    
    


    getResults() as $photo) { ?>
    getUrls()['small'];
        $photoDescription = $photo->getDescription();
        $photoCredit = $photo->getUser()['name'];
    ?>
    

        
        
Photo by 
    
    

在使用這個PHP檔案之前，先取代其中字串'YOUR_ACCESS_KEY'，使用在Unsplash API中註冊時所取得的API金鑰。

結論

上面就是我們使用PHP和Unsplash API進行圖片搜尋的整個流程。在進行Unsplash API映像搜尋時，請確保API金鑰的安全，並且必須從Unsplash官方取得API金鑰。同時，我們需要遵循Unsplash API服務使用規則，在規則允許範圍內進行影像搜尋和使用。

以上是如何使用PHP和Unsplash API進行圖像搜索的詳細內容。更多資訊請關注PHP中文網其他相關文章！