README

About

Spdy PHP is an opinionated amalgamation of libraries for creating blazing fast, reliable and modern REST API's with PHP using RoadRunner.

By using sane industry standard defaults, Spdy lets you focus on your application business value, instead of wasting cycles choosing and re-choosing various technologies and configurations.

On the most high level definition, Spdy is just implementing battle tested, industry standard libraries for PHP and bundling it together to form a fast and reliable skeleton for your REST API's.

Getting Stared

1. Install Spdy

composer require nickstarlight/spdy

1. Implement your application basic structure:

<?php declare(strict_types=1);

include_once './vendor/autoload.php';

/** Create a new app instance */
$app = new Nickstarlight\Spdy\App();

/** Get the default router instance */
$router = $app->getRouter();

/** Declare a route */
$router->get('/', fn () => [ 'message' => 'Hello World' ]);

/** Kickstart the event-loop */
$app->run();

1. Get the RoadRunner binary:

./vendor/bin/rr get-binary

1. Implement a basic Roadrunner PHP Worker configuration, create a new file named .rr.yaml with the following contents:

version: "2.7"

server:
  command: "php yourscript.php"

http:
  address: 0.0.0.0:8080

1. Start your application using the rr binary:

./rr serve

And you're good to go! Hit localhost:8080 and check your new route!

Documentation reference

As mentioned, Spdy does not try to reinvent the wheel, all libraries used are well known libraries, if you'd like to tweak anything or change the provided defaults, the bellow documentation is all you need:

FAQS

1. How do I declare routes?

   Check the League Route documentation for examples.

2. How do I configure the worker to fit my server needs? How do I setup healthchecks? Database connections? Environment variables?

   Roadrunner provides production-ready out-of-the-box configurations for those questions and many other features, check the Roadrunner configuration file reference.

3. I would like a robust ORM, broadcasting, views, integration with ReactJS/Vue/Svelte, etc...

   Spdy main goal is to provide a reliable, small and effient base for creating simple yet powerful REST API's, it does not attempt to replace complete frameworks. If you need more features, you should defintely aim for fully-fledged frameworks! Some good examples are Symfony, Laravel, Yii, Laminas and Phalcon.

Benchmarks

Check the benchmarks standalone repository for more information.

License

This work is licensed under the WTFPL license.