How to Integrate Grok AI into PHP Apps with the Grok‑PHP Client

Grok is a generative AI chatbot developed by xAI, launched in 2023 and updated to Grok 3 in February 2025, featuring humor and direct X (formerly Twitter) integration.

The Grok‑PHP library provides a lightweight, framework‑agnostic client for PHP developers to access Grok AI, supporting Laravel, Symfony (upcoming), and plain PHP.

Installation

composer require grok-php/client

Quick Start

Basic Usage

use GrokPHP\Client\Clients\GrokClient;
use GrokPHP\Client\Config\GrokConfig;
use GrokPHP\Client\Config\ChatOptions;
use GrokPHP\Client\Enums\Model;

$config = new GrokConfig('your-api-key');
$client = new GrokClient($config);

$messages = [
    ['role' => 'system', 'content' => 'You are an AI assistant.'],
    ['role' => 'user', 'content' => 'Tell me a joke!']
];

$options = new ChatOptions(model: Model::GROK_2, temperature: 0.7, stream: false);
$response = $client->chat($messages, $options);

echo "🤖 AI Response: " . $response['choices'][0]['message']['content'];

Advanced Configuration

use GrokPHP\Client\Clients\GrokClient;
use GrokPHP\Client\Config\GrokConfig;
use GrokPHP\Client\Config\ChatOptions;
use GrokPHP\Client\Enums\Model;

$apiKey = getenv('GROK_API_KEY');
$config = new GrokConfig($apiKey);
$client = new GrokClient($config);

$messages = [
    ['role' => 'system', 'content' => 'You are a helpful assistant.'],
    ['role' => 'user', 'content' => 'How do black holes form?']
];

$options = new ChatOptions(
    model: Model::GROK_2_LATEST,
    temperature: 1.2,
    stream: false
);
$response = $client->chat($messages, $options);

echo "🚀 AI Says: " . $response['choices'][0]['message']['content'];

Available Grok AI Models

The package includes a Model enum that maps to the API model names, each optimized for different use cases: Model::GROK_VISION_BETA – grok-vision-beta : experimental vision‑enabled model Model::GROK_2_VISION – grok-2-vision : advanced multi‑modal vision model Model::GROK_2_VISION_LATEST – grok-2-vision-latest : latest vision iteration Model::GROK_2_VISION_1212 – grok-2-vision-1212 : enhanced vision with performance gains Model::GROK_2_1212 – grok-2-1212 : optimized chat model Model::GROK_2 – grok-2 : default general‑purpose model Model::GROK_2_LATEST – grok-2-latest : latest Grok‑2 iteration Model::GROK_BETA – grok-beta : experimental beta model

Streaming Responses

Grok API supports streaming for real‑time interaction. Enable it by setting stream:true in ChatOptions:

$options = new ChatOptions(model: Model::GROK_2, temperature: 0.7, stream: true);
$response = $client->chat($messages, $options);

Streaming is useful for chatbots, live applications, and CLI assistants.