uhin/laravel_api

Tuesday, July 3, 2018
by rmclellanduhin
Repository
0 Watchers
0 Stars
236 Installations

PHP
0 Dependents
0 Suggesters
1 Forks
0 Open issues
41 Versions
45 % Grown

The README.md

laravel_api

Devs: To create a new release for composer you need to make your commit, add a tag (new version number), and then push the commit and the tag., _(*1)

In PHPStorm: Commit, click on log, right click on commit and add tag, push (check push tags)., _(*2)

For development:, _(*3)

In a service using this library you will make two changes to the composer.json to do development., _(*4)

First change the version of the require for this library to either: "dev-master", "1.x-dev", or "2.x-dev" - depending on which branch you are working on., _(*5)

Second add this block of code to your composer.json (editing the path):, _(*6)

"repositories": [
    {
        "type": "path",
        "url": "/Users/rmclelland/Projects/laravel_api"
    }
]

Run composer update from your project directory. This will create a symlink between the library and the project using this library., _(*7)

composer update uhin/laravel_api

Upgrade guides

Review these documents when upgrading versions., _(*8)

V1 to V2 Upgrade Guide, _(*9)

V2 to V3 Upgrade Guide, _(*10)

Using Rabbit

Rabbit Builders

php artisan uhin:make:rabbit-builder, _(*11)

The constructor stubs out the configuration for the builder. Modify the constructor to suit your needs. In previous versions of the builder the changes were made in the builder method. This is no longer required but, if needs be, the builder can still be overridden., _(*12)

public function __construct()
{
        parent::__construct();

        // You can overwrite these parent values
        // $this->exchange = config('uhin.rabbit.exchange');
        // $this->queue = config('uhin.rabbit.queue');
        // $this->routingKey = config('uhin.rabbit.routing_key');
        // $this->connectionName = 'default';
}

Rabbit Sender

Single Messages

To send a message to RabbitMQ there are a few ways to do so. The most basic method uses the default exchange, and routing key from the .env., _(*13)

(new RabbitSender)->send(json_encode([
       'job_id' => '12312312',
       'source' => 'sftp',
       'filename' => 'test-file.x12',
       'data' => 'alskfl'
   ]));

Another method to send to RabbitMQ takes a RabbitBuilder as a parameter. The sender can now use the parameters of the builder to determine the exchange and routing key., _(*14)

$rabbit = new RabbitSender(true, new MPILookupQueueBuilder());
$rabbit->send(json_encode($message));

The properties of a sender can also be overridden., _(*15)

$rabbit->setExchange(config('uhin.workers.lookup_mpi_exchange'));
$rabbit->setRoutingKey(config('uhin.workers.lookup_mpi_routing_key'));

Batch Sending

Same usage as single message sending. The sendBatch() method takes an array of messsages and send them in batch. Performance for larger quantities of messages is significantly better., _(*16)

Rabbit Receiver

The receiver can also take a builder and fills the properties for connecting to RabbitMQ., _(*17)

Starting/Stopping/Draining Workers

Starting

php artisan uhin:workers:start, _(*18)

Stopping

php artisan uhin:workers:stop, _(*19)

Drain

php artisan uhin:workers:drain, _(*20)

Using Twilio SendGrid

First, make sure that you have specified the following config values. The SendGridTemplate class will use these configs: - config('mail.from.address') - config('mail.from.name') - config('mail.sendgrid.api-key'), _(*21)

Templates

Example of how to send an email using a SendGrid email template and the SendGridTemplate class:, _(*22)

$templateId = config('mail.sendgrid.template.test');
$email = new SendGridTemplate($templateId);

// Send the email to user1, and CC user2 and user3
$metaDataA = new \SendGrid\Mail\Personalization();
$metaDataA->addDynamicTemplateData('sendgrid_var_1', 'custom data value 1');
$metaDataA->addDynamicTemplateData('sendgrid_var_2', 'custom data value 2');
$metaDataA->addCc(new \SendGrid\Mail\Cc('user2@test.com', 'User 2'));
$metaDataA->addCc(new \SendGrid\Mail\Cc('user3@test.com', 'User 3'));
$email->addRecipient('user1@test.com', 'User 1', $metaDataA);

// Send the email to user4, and BCC user5
$metaDataB = new \SendGrid\Mail\Personalization();
$metaDataB->addDynamicTemplateData('sendgrid_var_1', 'custom data value 3');
$metaDataB->addDynamicTemplateData('sendgrid_var_2', 'custom data value 4');
$metaDataB->addBcc(new \SendGrid\Mail\Bcc('user5@test.com', 'User 5'));
$email->addRecipient('user4@test.com', 'User 4', $metaDataB);

// Send out the email template with data attached to it
$email->send();

The Versions

03/07 2018

dev-master

9999999-dev

library laravel_api

uhin/laravel_api

The README.md

laravel_api

Upgrade guides

Using Rabbit

Rabbit Builders

Rabbit Sender

Single Messages

Batch Sending

Rabbit Receiver

Starting/Stopping/Draining Workers

Starting

Stopping

Drain

Using Twilio SendGrid

Templates

The Versions

dev-master

The Requires

by rmclelland

by chejazi

1.1.13

The Requires

by rmclelland

by chejazi

1.1.12

The Requires

by rmclelland

by chejazi

1.1.11

The Requires

by rmclelland

by chejazi

1.1.10

The Requires

by rmclelland

by chejazi

1.1.9

The Requires

by rmclelland

by chejazi

1.1.8

The Requires

by rmclelland

by chejazi

1.1.7

The Requires

by rmclelland

by chejazi

1.1.6

The Requires

by rmclelland

by chejazi

1.1.5

The Requires

by rmclelland

by chejazi

1.1.4

The Requires

by rmclelland

by chejazi

1.1.3

The Requires

by rmclelland

by chejazi

1.1.2

The Requires

by rmclelland

by chejazi

1.1.1

The Requires

by rmclelland

by chejazi

1.1.0

The Requires

by rmclelland

by chejazi

1.0.27

The Requires