peterfox/runscope

This package makes using Runscope in applications easy, including Guzzle and GuzzleHttp plugin

Runscope for PHP

• Requires a free Runscope account, sign up here
• Makes it easy to generate Runescope urls
• Provides plugins for both Guzzle (3.0) and GuzzleHttp (4.0)
• Has dependancy injection support for Laravel 4, through included ServiceProvider and Facade classes

Install by issuing:, _(*1)

composer require peterfox/runscope

The most basic usage is as follows:, _(*2)

<?php
require __DIR__ . '/../vendor/autoload.php';

use Runscope\Runscope;

$runscope = new Runscope('api-key-here');

$runscopeUrl = $runscope->proxify('https://api.github.com');

Please note, generating these urls will always provide a url that works on port 80/443 for http/https respectively as using ports other than the standard ones for a protocol requires headers., _(*3)

Using with Guzzle/GuzzleHttp

applying the plugin is like so for Guzzle:, _(*4)

<?php
require __DIR__ . '/../vendor/autoload.php';

use Runscope\Runscope;
use Guzzle\Http\Client;
use Runscope\Plugin\Guzzle\RunscopePlugin;

$runscope = new Runscope('api-key-here');

$client = new Client('https://api.github.com');

$runscopePlugin = new RunscopePlugin($runscope);

// Add the plugin
$client->addSubscriber($runscopePlugin);

// Send the request and get the response
$response = $client->get('/')->send();

Using the GuzzleHttp Plugin can be done with:, _(*5)

<?php
require __DIR__ . '/../vendor/autoload.php';

use Runscope\Runscope;
use GuzzleHttp\Client;
use Runscope\Plugin\GuzzleHttp\RunscopePlugin;

$runscope = new Runscope('api-key-here');

$client = new Client('https://api.github.com');

$runscopePlugin = new RunscopePlugin($runscope);

// Attach the plugin
$client->getEmitter()->attach($runscopePlugin);

// Send the request and get the response
$response = $client->get('/');

Laravel 4 Integration

Add the service provider:, _(*6)

'providers' => array(
    ...
    'Runscope\RunscopeServiceProvider'
)

You can then publish the config file from the package:, _(*7)

php artisan config:publish peterfox/runscope

The blank config will at a minimum require your bucket key (ID):, _(*8)

<?php

return array(
    'bucket_key' => '',
    'auth_token' => null,
    'gateway_host' => 'runscope.net'
);

With the service provider in place it will also set up the Facade for you so you can use:, _(*9)

$url = Runscope::proxify('https://api.github.com');

You'll also have a helper function which makes things a little lighter, _(*10)

$url = runscope_url('https://api.github.com');