PHPとUnsplash APIを使用して画像検索を行う方法

インターネットの発展により、画像はデジタル時代で最も人気のあるメディア形式の 1 つになりました。 Web 開発者にとって、画像ベースの機能を実装したり、ページを美しくしたりするために、Web プロジェクト開発では画像の検索と使用が避けられなくなりました。 Unsplash は、最も人気のある無料の写真および画像ライブラリの 1 つです。この記事では、PHPとUnsplash APIを使って画像検索を行う方法を紹介します。

1. Unsplash API キーの登録

まず、Unsplash API キーを登録する必要があります。登録方法は非常に簡単で、Unsplash APIの公式サイトにアクセスし、必要事項を入力してAPIキーを取得するだけです。登録の際は、個人情報とプロジェクトの詳細を入力する必要があります。登録するとAPIキーを受け取ります。後の手順で必要になるため、覚えておいてください。

2. Unsplash API の導入

Unsplash API をプロジェクトに導入します。これは、公式に提供されている Javascript、PHP、または Python ライブラリを通じて導入できます。ここでは、PHP バージョンのライブラリを使用してデモンストレーションを行うことを選択します。

Unsplash API は、composer コマンドを使用するか、プロジェクトにソース コードを直接ダウンロードすることによって導入できます。 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);

これで、旅行関連の画像が正常に検索されました。また、これらの画像の情報を抽出して Web ページに表示する必要もあります。

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 と説明を抽出します。同時に、各画像を撮影した人の名前 (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 中国語 Web サイトの他の関連記事を参照してください。