PHP code example of sebastiankrupinski / jmap-client-php

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

sebastiankrupinski / jmap-client-php example snippets

use JmapClient\Client;
use JmapClient\Authentication\Basic;

// Create a new client
$client = new Client();

// Configure transport
$client->configureTransportMode('https');
$client->setHost('jmap.example.com:443');
$client->configureTransportVerification(true);

// Set up authentication
$auth = new Basic('[email protected]', 'password');
$client->setAuthentication($auth);

// Connect to the JMAP server
$session = $client->connect();
echo "Connected to: " . $session->apiUrl();

// Access the default account for core operations
$account = $client->sessionAccountDefault();
if ($account !== null) {
    echo "Account ID: " . $account->id();
}

use JmapClient\Client;
use JmapClient\Authentication\Basic;

$client = new Client();
$client->configureTransportMode('https');
$client->setHost('jmap.example.com:443');
$client->configureTransportVerification(true);

// Basic authentication with username and password
$auth = new Basic('[email protected]', 'password');
$client->setAuthentication($auth);

// Connect to establish the session
$session = $client->connect();

use JmapClient\Client;
use JmapClient\Authentication\Bearer;

$client = new Client();
$client->configureTransportMode('https');
$client->setHost('jmap.example.com:443');
$client->configureTransportVerification(true);

// Bearer token authentication
$auth = new Bearer('[email protected]', 'your-access-token', 1735689600);
$client->setAuthentication($auth);

$session = $client->connect();

use JmapClient\Requests\Mail\MailboxGet;
use JmapClient\Requests\Mail\MailboxQuery;

$client = // ... (setup client from examples above)

// Get the default account for mail
$account = $client->sessionAccountDefault('mail');
if ($account === null) {
    echo "No mail account found";
    exit;
}

// Construct request to find the mailbox by name
$request = new MailboxQuery($account->id());
$request->filter()->name('Inbox');

// Execute the request
$bundle = $client->perform([$request]);
$response = $bundle->first();

// Extract the matching mailbox identifiers
$identifiers = $response->list();
if ($identifiers === []) {
    echo "Inbox mailbox not found";
    exit;
}

// Construct request for the mailbox details
$request = new MailboxGet($account->id());
$request->target($identifiers[0]);

// Execute the request
$bundle = $client->perform([$request]);

// Extract the first and only response
$response = $bundle->first();

// Extract the first object
$inbox = $response->object(0);

// Use the mailbox details
echo "Mailbox: " . $inbox->label() . "\n";
echo "Unread messages: " . ($inbox->objectsUnseen() ?? 0) . "\n";

use JmapClient\Requests\Mail\MailGet;
use JmapClient\Requests\Mail\MailQuery;

$client = // ... (setup client and resolve $inbox from the mailbox example above)

// Get the default account for mail
$account = $client->sessionAccountDefault('mail');
if ($account === null) {
    echo "No mail account found";
    exit;
}

// Construct request to find all the messages in the inbox
$request1 = new MailQuery($account->id());
$request1->filter()->in($inbox->id());
$request1->sort()->received(false);

// Construct request to retrieve the message details
// for the all messages found in the first request 
$request2 = new MailGet($account->id());
$request2->targetFromRequest($mailQuery, '/ids');
$request2->property('id', 'subject', 'from', 'receivedAt', 'preview', 'bodyStructure', 'bodyValues');
$request2->bodyText(true);
$request2->bodyHtml(true);
$request2->bodyTruncate(16384);

// Execute both requests in a single batch
$bundle = $client->perform([$request1, $request2]);

// Extract the second response with message details
$response = $bundle->response(1);

// Process the resulting messages
foreach ($response->objects() as $message) {
    echo "Subject: " . ($message->subject() ?? '(no subject)') . "\n";
    echo "Received: " . ($message->received() ?? 'unknown') . "\n";
    echo "Preview: " . ($message->bodyTextPreview() ?? 'n/a') . "\n";

    $from = $message->from();
    if (!empty($from)) {
        $author = $from[0]['name'] ?? $from[0]['email'] ?? 'unknown sender';
        echo "From: " . $author . "\n";
    }

    foreach ($message->attachments() as $attachment) {
        echo "Attachment: " . ($attachment->name() ?? $attachment->id() ?? 'unnamed') . "\n";
    }

    echo "---\n";
}

use JmapClient\Requests\Contacts\AddressBookGet;

$client = // ... (setup client from examples above)

// Get the default account for contacts
$account = $client->sessionAccountDefault('contacts');
if ($account === null) {
    echo "No contacts account found";
    exit;
}

$accountId = $account->id();

// Construct request to fetch all address books
$request = new AddressBookGet($accountId);

// Execute the request
$bundle = $client->perform([$request]);

// Extract the response for the first request
$response = $bundle->first();

// Process the results
foreach ($response->objects() as $addressBook) {
    echo "Address Book: " . $addressBook->label() . " (ID: " . $addressBook->id() . ")\n";
}

use JmapClient\Requests\Contacts\ContactGet;

// Construct request to retrieve a specific contacts by ID
$request = new ContactGet($accountId);
$request->target('contact-id-1', 'contact-id-2', 'contact-id-3');

// You can also limit properties to fetch
$request->property('id', 'uid', 'name', 'emails');

// Execute the request
$bundle = $client->perform([$request]);
$response = $bundle->first();

// Access contact properties
foreach ($response->objects() as $contact) {
    if ($contact->name() !== null) {
        echo "Name: " . json_encode($contact->name()->components()) . "\n";
    }
    
    if ($contact->emails() !== null) {
        foreach ($contact->emails() as $email) {
            echo "  Email: " . $email->email() . " (" . ($email->type() ?? 'personal') . ")\n";
        }
    }
}

use JmapClient\Requests\Contacts\ContactQuery;
use JmapClient\Requests\Contacts\ContactGet;

$account = $client->sessionAccountDefault('contacts');
$accountId = $account->id();

// Construct a request to query for all contacts in a specific address book
$request1 = new ContactQuery($accountId);
// Set up filter for the address book
$request1->filter()->in('address-book-id');

// Then create a request to fetch the contact details
// using the IDs from the query result
$request2 = new ContactGet($accountId);
$request2->targetFromRequest($request1, '/ids');

// Perform both requests in a single batch
$bundle = $client->perform([$request1, $request2]);

// Get the response to the GET request (second request, index 1)
$response = $bundle->response(1);

// Process all contacts
foreach ($response->objects() as $contact) {
    echo $contact->id() . ": " . json_encode($contact->name()) . "\n";
}

// Check if server supports specific JMAP extensions
$supportsContacts = $client->sessionCapable('contacts');
$supportsMail = $client->sessionCapable('mail');
$supportsTasks = $client->sessionCapable('tasks');

// Get all available capabilities
$capabilities = $client->sessionCapabilities();
if ($capabilities !== null) {
    foreach ($capabilities->objects() as $capability => $data) {
        echo "Capability: " . $capability . "\n";
    }
}

// Get session status
if ($client->sessionStatus()) {
    echo "Client is connected\n";
}

// Get session data
$session = $client->sessionData();
if ($session !== null) {
    echo "API URL: " . $session->apiUrl() . "\n";
    echo "Download URL: " . $session->downloadUrl() . "\n";
    echo "Upload URL: " . $session->uploadUrl() . "\n";
}

// Get all available accounts
$accounts = $client->sessionAccounts();
if ($accounts !== null) {
    foreach ($accounts->objects() as $account) {
        echo "Account: " . $account->id() . " (" . $account->name() . ")\n";
    }
}

$client = new Client();

// Set transport mode (http or https)
$client->configureTransportMode('https');

// Configure host and port
$client->setHost('jmap.example.com:443');

// Set custom discovery path (if server uses non-standard JMAP endpoint)
$client->setDiscoveryPath('/.well-known/jmap');

// Enable/disable SSL verification
$client->configureTransportVerification(true);

// Set custom user agent
$client->setTransportAgent('MyApplication/1.0');

// Configure transport version (HTTP version)
$client->configureTransportVersion(2);

// Enable transport logging to file for debugging
$client->configureTransportLogState(true);
$client->configureTransportLogLocation('/var/log/jmap-client.log');

// This logs all HTTP requests and responses for debugging

// You can also retain specific transport data
$client->retainTransportRequestHeader(true);
$client->retainTransportRequestBody(true);
$client->retainTransportResponseHeader(true);
$client->retainTransportResponseBody(true);

// Retrieve the logged data
$requestHeaders = $client->discloseTransportRequestHeader();
$requestBody = $client->discloseTransportRequestBody();
$responseCode = $client->discloseTransportResponseCode();
$responseHeaders = $client->discloseTransportResponseHeader();
$responseBody = $client->discloseTransportResponseBody();

// Enable certificate verification (recommended for production)
$client->configureTransportVerification(true);

// Disable verification (NOT recommended - use only for testing with self-signed certificates)
$client->configureTransportVerification(false);

use JmapClient\Requests\Contacts\AddressBookGet;
use JmapClient\Responses\ResponseException;

try {
    $client = // ... (setup client)
    
    $account = $client->sessionAccountDefault('contacts');
    if ($account === null) {
        echo "No contacts account available";
        exit;
    }
    
    $request = new AddressBookGet($account->id());
    $response = $client->perform([$request]);
    
    // Get the response
    $result = $response->response(0);
    
    // Check if the response is an error
    if ($result instanceof ResponseException) {
        $errorType = $result->type(); // e.g., 'unknownMethod', 'invalidArguments'
        $errorMessage = $result->description();
        
        echo "JMAP Error: $errorType\n";
        echo "Message: $errorMessage\n";
        
        // Handle specific error types
        switch ($errorType) {
            case 'unknownMethod':
                echo "The requested method is not supported by the server\n";
                break;
            case 'invalidArguments':
                echo "Invalid arguments were provided to the request\n";
                break;
            case 'requestTooLarge':
                echo "Request payload exceeds server limits\n";
                break;
            case 'stateMismatch':
                echo "The state parameter doesn't match - you may need to re-sync\n";
                break;
        }
    } else {
        // Process successful response
        foreach ($result->objects() as $addressBook) {
            echo "Found: " . $addressBook->label() . "\n";
        }
    }
} catch (Exception $e) {
    // Handle connection or transport errors
    echo "Connection error: " . $e->getMessage() . "\n";
}

bash
composer