nevon/swiftype

A PHP client for Swiftype, a search and autocomplete API for developers.

swiftype-php

A PHP client for Elastic Site Search, a search and autocomplete API for developers., _(*1)

⚠️ This integration is deprecated and you should use the official client instead., _(*2)

Example usage

require 'swiftype.php';

$client = new \Swiftype\SwiftypeClient('your@email.com', 'password', 'api_key');

print_r($client->create_engine('library'));

print_r($client->create_document_type('library', 'books'));

print_r($client->create_document('library', 'books', array(
    'external_id' => '1',
    'fields' => array(
        array(
            'name' => 'title',
            'value' => 'The Art of Community',
            'type' => 'string'
        ),
        array(
            'name' => 'author',
            'value' => 'Jono Bacon',
            'type' => 'enum'
        )
    )
)));

print_r($client->documents('library', 'books'));

Documentation

The library should conform to the documentation found here., _(*3)

__construct([username String], [password String], [api_key String], [host String], [api_base_path String])

The constructor for the SwiftypeClient object. Set your authentication information here. You can supply either an API key or a username (email) and password combination., _(*4)

$client = new \Swiftype\SwiftypeClient('your@email.com', 'password', 'api_key');, _(*5)

engines()

Returns all your engines, _(*6)

$client->engines();, _(*7)

engine(engine_id String)

Returns a specific engine., _(*8)

$client->engine('library');, _(*9)

create_engine(engine_id String)

Creates a new engine, _(*10)

$client->create_engine('library');, _(*11)

destroy_engine(engine_id String)

Destroys an engine, _(*12)

$client->destroy_engine('library');, _(*13)

document_types(engine_id String)

Returns a list of all the document types for a certain engine, _(*14)

$client->document_types('library');, _(*15)

document_type(engine_id String, document_type_id String)

Fetches a specific document_type., _(*16)

$client->document_type('library', 'books');, _(*17)

create_document_type(engine_id String, document_type_id String)

Creates a document type for a specific engine., _(*18)

$client->create_document_type('library', 'books');, _(*19)

destroy_document_type(engine_id String, document_type_id String)

Destroys a document type., _(*20)

$client->destroy_document_type('library', 'books');, _(*21)

documents(engine_id String, document_type_id String)

Returns all documents for a certain engine and document type., _(*22)

$client->documents('library', 'books');, _(*23)

document(engine_id String, document_type_id String, document_id String)

Returns a specific document., _(*24)

$client->document('library', 'books', '1');, _(*25)

create_document(engine_id String, document_type_id String, document Array)

Creates a document. A document is an associative array containing an external_id and a number of fields. See [this](http://swiftype.com/documentation/overview# field_types) for more information on fields and types., _(*26)

$client->create_document('library', 'books', array(
    'external_id' => '1',
    'fields' => array(
        array(
            'name' => 'title',
            'value' => 'The Art of Community',
            'type' => 'string'
        ),
        array(
            'name' => 'author',
            'value' => 'Bono Jacon',
            'type' => 'enum'
        )
    )
));

create_or_update_document(engine_id String, document_type_id String, document Array)

Same as create_document, except it updates an existing document if there is one., _(*27)

$client->create_or_update_document('library', 'books', array(
    'external_id' => '1',
    'fields' => array(
        array(
            'name' => 'author',
            'value' => 'Jono Blargon',
            'type' => 'enum'
        )
    )
));

update_document(engine_id String, document_type_id String, document_id String, fields Array)

Updates a single document with the specified document_id., _(*28)

$client->update_document('library', 'books', '1', array('author' => 'Jorbo Bacon'));

update_documents(engine_id String, document_type_id String, documents Array)

Batch operation for updating documents. documents is simply an array containing arrays of the same type that we supplied to the create_documentmethod., _(*29)

$client->update_documents('library', 'books', array(
    array(
        'external_id' => '1',
        'fields' => array(
            'name' => 'author',
            'value' => 'Jono Bacon',
        )
    )
));

destroy_document(engine_id String, document_type_id String, document_id String)

Destroys a document., _(*30)

$client->destroy_document('library', 'books', '1');, _(*31)

destroy_documents(engine_id String, document_type_id String, document_ids Array)

Destroy documents in bulk. document_ids is a simple array containing the external_ids of the documents you wish to destroy., _(*32)

$client->destroy_documents('library', 'books', array('1', '2'));, _(*33)

search(engine_id String, [document_type_id String], query String, [options Array])

If you do not supply a document_type_id, search searches through the specified engine to find a document type that matches the query. If a document_type_id is supplied, then search searches through that particular document type in that engine for a document that matches the query., _(*34)

To see what options are available, see the documentation., _(*35)

$client->search('library', 'books', 'community', array(
    'per_page' => 5
));

suggest(engine_id String, query String, [options Array])

Used for autocompletion. See the documentation for more information., _(*36)

$client->suggest('library', 'Bacon', array(
    'search_fields' => 'author'
));