dts/ebay-sdk-finding

An eBay SDK for PHP. Use the eBay Finding API in your PHP projects.

Installs: 1 756

Dependents: 2

Stars: 10

Watches: 2

Forks: 4

Language: PHP

0.2.1 2015-03-01 17:29 UTC

README

Build Status

This project enables PHP developers to use the eBay API in their PHP code, and build software using the Finding service. You can get started by installing the SDK via Composer and by following the Getting Started Guide.

Features

Resources

  • User Guides - Getting started guide and in-depth information.
  • SDK Versions - A complete list of each SDK, and the API version they support.
  • Sample Project - Provides several examples of using the SDK.
  • Google Group - Join for support with the SDK.
  • @devbaydotnet - Follow on Twitter for announcements of releases, important changes and so on.

Requirements

  • PHP 5.3.3 or greater with the following extensions:
    • cURL
    • libxml
  • 64 bit version of PHP recommended as there are some issues when using the SDK with 32 bit.
  • SSL enabled on the cURL extension so that https requests can be made.

Installation

The SDK can be installed with Composer. Please see the Installation section of the User Guide to learn about installing through other means.

  1. Install Composer.

     curl -sS https://getcomposer.org/installer | php
    
  2. Install the SDK.

     php composer.phar require dts/ebay-sdk-finding
    
  3. Require Composer's autoloader by adding the following line to your code.

     require 'vendor/autoload.php';

Example

Keyword search
<?php

require 'vendor/autoload.php';

use \DTS\eBaySDK\Constants;
use \DTS\eBaySDK\Finding\Services;
use \DTS\eBaySDK\Finding\Types;

// Create the service object.
$service = new Services\FindingService(array(
    'appId' => 'YOUR_PRODUCTION_APPID_APPLICATION_KEY',
    'globalId' => Constants\GlobalIds::US
));

// Create the request object.
$request = new Types\FindItemsByKeywordsRequest();

$request->keywords = 'Harry Potter';

// Send the request to the service operation.
$response = $service->findItemsByKeywords($request);

// Output the result of calling the service operation.
foreach ($response->searchResult->item as $item) {
    printf("(%s) %s: %s %.2f\n",
        $item->itemId,
        $item->title,
        $item->sellingStatus->currentPrice->currencyId,
        $item->sellingStatus->currentPrice->value
    );
}

Project Goals

Project Maturity

This is a personal project that has been developed by me, David T. Sadler. I decided to create this project to make up for the lack of an official SDK for PHP. It is in no way endorsed, sponsored or maintained by eBay.

As this is a brand new project you should expect frequent releases until it reaches the stable 1.0.0 target. I will endeavour to keep changes to a minimum between each release and any changes will be documented.

License

Licensed under the Apache Public License 2.0.

Copyright 2014 David T. Sadler