過去バージョン

GET 通信とは

HTTP の代表的なメソッドの一つで、サーバから情報を取得するのが本来の用途です。URL に ?key=value&key2=value2 形式でクエリ文字列を付与して送信し、サーバ側で読み取ります。

PHP 側で受け取る

 ctype_digit((string)$v));

// 全クエリを連想配列で
print_r($_GET);
// Array ( [q] => php [page] => 2 [ids] => Array ( [0] => 1 [1] => 2 ) )

// REQUEST_URI から自前パース
$urlParts = parse_url($_SERVER['REQUEST_URI']);
parse_str($urlParts['query'] ?? '', $params);

Laravel での受け取り

use Illuminate\Http\Request;

Route::get('/search', function (Request $request) {
    // query() はクエリ文字列のみ、input() は POST/GET 両対応
    $q    = $request->query('q', '');
    $page = (int) $request->query('page', 1);

    // 検証付き
    $validated = $request->validate([
        'q'    => 'nullable|string|max:100',
        'page' => 'integer|min:1|max:1000',
        'ids'  => 'array',
        'ids.*'=> 'integer',
    ]);

    return view('search.index', compact('q', 'page'));
});

// FormRequest 化
class SearchRequest extends FormRequest {
    public function rules(): array {
        return [
            'q'    => 'nullable|string|max:100',
            'page' => 'integer|min:1',
        ];
    }
}

curl で GET 送信（PHP 内から）

 true,
        CURLOPT_TIMEOUT        => 10,
        CURLOPT_FOLLOWLOCATION => true,
        CURLOPT_MAXREDIRS      => 3,
        CURLOPT_SSL_VERIFYPEER => true,
        CURLOPT_HTTPHEADER     => array_merge([
            'Accept: application/json',
            'User-Agent: MyApp/1.0',
        ], $headers),
    ]);

    $body   = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $err    = curl_error($ch);
    curl_close($ch);

    if ($body === false) {
        throw new RuntimeException("curl error: $err");
    }
    return ['status' => $status, 'body' => $body];
}

// 利用
$resp = httpGet('https://api.example.com/users', ['page' => 1, 'per_page' => 20]);
$data = json_decode($resp['body'], true);

Laravel HTTP Client

Laravel 7+ には Guzzle ベースの Http ファサードが入っています。最も読みやすい書き方です:

use Illuminate\Support\Facades\Http;

// 基本
$response = Http::get('https://api.example.com/users', [
    'page' => 1,
    'per_page' => 20,
]);

if ($response->successful()) {
    $data = $response->json();
}

// ヘッダ / タイムアウト / リトライ / 認証
$response = Http::withHeaders([
        'Accept-Language' => 'ja',
    ])
    ->withToken($token)            // Authorization: Bearer
    ->timeout(10)
    ->retry(3, 200)                // 3 回、200ms 間隔
    ->get('https://api.example.com/users', ['q' => 'php']);

// マクロ / プール（並列）
$responses = Http::pool(fn ($pool) => [
    $pool->get('https://api.example.com/a'),
    $pool->get('https://api.example.com/b'),
]);

Guzzle 直接利用

use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;

$client = new Client([
    'base_uri' => 'https://api.example.com',
    'timeout'  => 10,
    'http_errors' => false,           // 4xx/5xx で例外を投げない
]);

try {
    $response = $client->get('/users', [
        'query' => [
            'page' => 1,
            'ids'  => [10, 20, 30],     // ?ids[0]=10&ids[1]=20&ids[2]=30
        ],
        'headers' => ['Accept' => 'application/json'],
    ]);
    $data = json_decode((string)$response->getBody(), true);
} catch (GuzzleException $e) {
    error_log($e->getMessage());
}

配列・ネストの送信

 'php',
    'ids'     => [1, 2, 3],
    'filter'  => [
        'category' => 'book',
        'price'    => ['min' => 100, 'max' => 5000],
    ],
];

$qs = http_build_query($params);
// q=php
// &ids%5B0%5D=1&ids%5B1%5D=2&ids%5B2%5D=3
// &filter%5Bcategory%5D=book
// &filter%5Bprice%5D%5Bmin%5D=100&filter%5Bprice%5D%5Bmax%5D=5000

// 区切りを「&」「&」のどちらにするか
http_build_query($params, '', '&', PHP_QUERY_RFC3986);

URL エンコードの違い

CORS（クロスオリジン）の理解

ブラウザの JS から別オリジンの API を GET する場合、サーバ側でCORS ヘッダを返す必要があります:

// fetch API
const params = new URLSearchParams({ q: 'php', page: 2 });
fetch(`/api/search?${params}`, {
  headers: { Accept: 'application/json' },
})
  .then(r => r.json())
  .then(data => console.log(data));

// axios
import axios from 'axios';
const { data } = await axios.get('/api/search', {
  params: { q: 'php', page: 2, ids: [1, 2, 3] },
  paramsSerializer: { indexes: false },  // ?ids=1&ids=2 形式
});

# curl で GET
curl -G https://api.example.com/users \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "q=php" \
  --data-urlencode "page=2"

# ヘッダも表示
curl -i 'https://api.example.com/users?q=php'

# 詳細トレース
curl -v 'https://api.example.com/users?q=php'

# レスポンスを保存
curl -o out.json 'https://api.example.com/users'