octane

README

RoadRunner Plugin Template

This repo can be used to scaffold a RoadRunner Plugin. Follow these steps to get started:

1. Update the module name in go.mod

   module github.com/peterfox/roadrunner-plugin-template
   

2. Ideally you should rename the package in all the .go files from plugin to something else.

   package octane
   

3. Rename the plugin to whatever is appropriate, this should be kept to snake case:

   const PluginName = "plugin"
   

4. Update the LICENSE.md file

5. If your plugin is not going to be public on GitHub then you should remove .github/workflows/codeql-analysis.yml. You may also need to enable code scanning for the repository

6. Update the contributors in the README.md.

7. Update the README.md references to the plugin, installation and usage.

8. Update the badges at the top of README.md to point to your own repository.

9. Remove the todo section from your README.md

Installation

To use this plugin with RoadRunner you will need to fork or clone your own copy of the RoadRunner binary.

You can import the plugin via go modules:

go get github.com/peterfox/roadrunner-plugin-demo

From there you can edit the plugins.go file to import the plugin.

package container

import (
    // ...
    demoPlugin "github.com/ylsideas/octane-plugin"
    // ...
)

// Plugins returns active plugins for the endure container. Feel free to add or remove any plugins.
func Plugins() []interface{} {
	return []interface{}{
        // ...
        &demoPlugin.Plugin{},
        // ...
    }
}

By importing this plugin and registering it the plugin will be compiled into the final binary.

The plugin will require that the .rr.yaml config has the key plugin for the plugin won't initialise with roadrunner.

plugin:
  value: foobar

Usage

To make use of this plugin via PHP you must install the Spiral Goridge library.

You can use the following code as an example in php:

<?php

use Spiral\Goridge\RPC\RPC;
use Spiral\RoadRunner\Environment;

$rpc = RPC::create(Environment::fromGlobals()->getRPCAddress());

// returns ['message' => 'test']
$output = $rpc->call('plugin.Message', ['message' => 'test']);

Testing

You may download the project and test the plugin using the following command.

go test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Peter Fox
• All Contributors

License

The MIT License (MIT). Please see License File for more information.

Documentation

Index

• Constants
• type Config
  • func (cfg *Config) InitDefaults() error
• type Plugin
  • func (p *Plugin) Init(cfg config.Configurer) error
  • func (p *Plugin) Name() string

Constants

const PluginName = "octane"

PluginName is the name for the plugin as found inside the container

Types

type Config

type Config struct {
	// the Enabled property makes the plugin exit prematurely
	Enabled bool `mapstructure:"enable"`
	// the PHPBinary is the php executable path
	PHPBinary string `mapstructure:"php_binary"`
	// the AppBasePath is the path of the existing php project
	AppBasePath string `mapstructure:"app_path"`
	// the Environment is the Laravel environment to run the working in
	Environment string
}

Config configures metrics service.

func (*Config) InitDefaults

func (cfg *Config) InitDefaults() error

InitDefaults for the octane config

type Plugin

type Plugin struct {
	// contains filtered or unexported fields
}

func (*Plugin) Init

func (p *Plugin) Init(cfg config.Configurer) error

Init initiates the plugin with any injected services implementing endure.Container, returning an error if the plugin fails to start, if the error is of type errors.Disabled then the plugin will not be active

func (*Plugin) Name

func (p *Plugin) Name() string

Name returns endure.Named interface implementation