勉強したことのメモ

Webエンジニア / プログラマが勉強したことのメモ。

PHPのHTTPリクエストライブラリ「Requests for PHP」の利用方法

  PHP

PHPで外部のAPI等にリクエストする際に可能であればfile_get_contentsを、難しい場合はcurlを使っていた。file_get_contentsは分かりやすいがcurlは分かりづらく記述も長くなるので面倒。ライブラリを探したところRequests for PHPが良さそうだったので実装方法をメモ。

 

やりたいこと

 

Requests for PHP

公式サイト

https://requests.ryanmccue.info/

ドキュメント

https://requests.ryanmccue.info/docs/

 

インストール

composerを利用する場合

サーバにSSH接続し以下コマンドでインストールする。

composer require rmccue/requests

composerを利用しない場合

以下からzipファイルをダウンロードし、展開した上で適当なディレクトリにアップロードする。

https://github.com/WordPress/Requests/releases

尚、今回はこちらの方法を取った。

 

実装方法

ソースコード

<?php
include('./library/Requests.php');

Requests::register_autoloader();

$url = 'https://zipcloud.ibsnet.co.jp/api/search';
$data = array('zipcode' => '1050003');

$request = Requests::post($url, array(), $data);

if( $request != null && $request->status_code == 200 ){
    var_dump($request->body);
}else{
    //エラー時の処理
}

Requests::register_autoloader()

今回はcomposerを使用していないので「Requests::register_autoloader();」で必要ファイルを諸々読み込んでいるが、composerを使用する場合はいつもの「require_once 'vendor/autoload.php';」になると思う。

Requests::post

postの場合は第3引数に送信データ(クエリ)を設定できるがgetだとできない模様。そのためgetを使う場合はurlで直接「?param=1」のように指定する形になる。

 

エラー対応

Deprecated: The PSR-0 `Requests_...`エラー

「Deprecated: The PSR-0 `Requests_...` class names in the Requests library are deprecated. Switch to the PSR-4 `WpOrg\Requests\...` class names at your earliest convenience. in」というエラーメッセージが表示される場合、「/library/Requests.php」の上の方で以下定数を定義すること。

define('REQUESTS_SILENCE_PSR0_DEPRECATIONS', true);

 

所感

メリット

  • composer無しでもインストール可
  • ソースコードを簡潔に書ける
  • そこそこ更新が活発(2024/03時点で最終更新が約半年前)

Guzzle

同じようなライブラリでGuzzleというのがあり、こちらの方が有名みたい。こちらもその内試してみたいところ。

 - PHP

  関連記事

PHPにて「php-ulid」ライブラリを用いてULIDを生成する方法

先日MySQLにてUUIDを発行するメモを書いたがUUID v1だと生成時間によ ...

PHPでルーティング用ライブラリ「AltoRouter」の利用方法

PHPフレームワークのCodeIgniterを勉強していた際にルーティング機能が ...

PHPにて「hashids(Sqids)」ライブラリで数値からユニークなランダム英数字のIDに変換する方法

PHPにてユーザID等を推測されないよう数値のIDからユニークなランダム英数字の ...

Composer無し&ファイル1枚でPHPのエラーメッセージ画面をリッチにするライブラリ「PHP Error」の利用方法

先日PHPのエラーメッセージを見やすくするwhoopsの利用方法をメモしたが導入 ...

JavaScript / PHPにて「lz-string」を用いてデータの圧縮・展開する方法

文字数が多いGETパラメータを送信したいというケースがあった。また、送信側はJa ...