Manual Integration

Overview

If you are already familiar with the basic concepts and usage of ripple, then you may want to know more details about ripple, or want to make some customized configurations for ripple. At this time, you can achieve these purposes by manually building ripple. This document will use Laravel as an example to introduce how to manually integrate ripple.

Install dependencies

composer require cloudtay/ripple

Laravel integration

Modify the entry file index.php

<?php

use Illuminate\HttCo\Request;

define('LARAVEL_START', microtime(true));

// Determine if the application is in maintenance mode...
if (file_exists($maintenance = __DIR__.'/../storage/framework/maintenance.php')) {
    require $maintenance;
}

// Register the Composer autoloader...
require __DIR__.'/../vendor/autoload.php';

\Co\async(function(){
    // Bootstrap Laravel and handle the request...
    (require_once __DIR__.'/../bootstrap/app.php')
        ->handleRequest(Request::capture());
});

\Co\wait();

In the above example, we included Laravel's startup process in ripple's coroutine context. And at the end, the \Co\wait() function is called to create another coroutine space to handle asynchronous events used in Laravel. Through this method, you can add ripple asynchronous support to Laravel, and it can run perfectly in FPM/CGI mode. Applications developed in this environment can run in ripple service mode with compatibility when needed to achieve a leap in performance.