https://github.com/jonathanstowe/raku-fcgi-psgi

This is a PSGI interface for FastCGI::NativeCall
https://github.com/jonathanstowe/raku-fcgi-psgi

fastcgi psgi raku

Last synced: 25 days ago
JSON representation

This is a PSGI interface for FastCGI::NativeCall

• Host: GitHub
• URL: https://github.com/jonathanstowe/raku-fcgi-psgi
• Owner: jonathanstowe
• License: isc
• Created: 2017-01-23T21:36:09.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2022-08-07T08:48:13.000Z (over 2 years ago)
• Last Synced: 2023-04-22T17:07:00.087Z (over 1 year ago)
• Topics: fastcgi, psgi, raku
• Language: Raku
• Homepage:
• Size: 19.5 KB
• Stars: 0
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: Changes

Awesome Lists containing this project

README

        
# FastCGI::NativeCall::PSGI

This is a PSGI interface for [FastCGI::NativeCall](https://github.com/jonathanstowe/raku-fastcgi-nativecall)

![Build Status](https://github.com/jonathanstowe/raku-fcgi-psgi/workflows/CI/badge.svg)

## Synopsis

Basic usage:

```raku

use FastCGI::NativeCall::PSGI;

my $psgi = FastCGI::NativeCall::PSGI.new(path => "/tmp/fastcgi.sock", backlog => 32);

sub dispatch-psgi($env) {

    return [ 200, { Content-Type => 'text/html' }, "Hello world" ];

}

$psgi.run(&dispatch-psgi);

```

Using [Bailador](https://github.com/Bailador/Bailador):

```raku

use FastCGI::NativeCall::PSGI;

use Bailador;

get "/" => sub {

    "Hello world";

}

my $psgi = FastCGI::NativeCall::PSGI.new(path => "/tmp/fastcgi.sock", backlog => 32);

$psgi.run(get-psgi-app());

```

Using [Crust](https://github.com/tokuhirom/p6-Crust):

```raku

use FastCGI::NativeCall::PSGI;

use Crust::Builder;

my &app = builder {

    mount "/" , sub (%env) {

        start { 200, [Content-Type => "text/html"], ["Hello world"] };

    }

};

my $psgi = FastCGI::NativeCall::PSGI.new(path => "/tmp/fastcgi.sock", backlog => 32);

$psgi.run(&app);

```

A suitable nginx configuration for these can be found in the [examples](examples) directory.

If you are using Apache httpd with [mod_fcgid](https://httpd.apache.org/mod_fcgid/mod/mod_fcgid.html)

then your script will be executed by the server with its STDIN (file descriptor 0) reopened to

a listening socket that has already been created for you, in this case your constructor will

become:

```raku

my $psgi = FastCGI::NativeCall::PSGI.new(sock => 0);

```

There is a snippet of Apache configuration in the [examples](examples/apache.conf) directory. You

will almost certainly want to tweak that to your own requirements.

## Description

[FastCGI](https://fastcgi-archives.github.io/) is a protocol that allows

an HTTP server to communicate with a persistent application over a

socket, thus removing the process startup overhead of, say, traditional

CGI applications.  It is supported as standard (or through supporting

modules,) by most common HTTP server software (such as Apache, nginx,

lighthttpd and so forth.)

This module builds on

[FastCGI::NativeCall](https://github.com/jonathanstowe/raku-fastcgi-nativecall) to

provide a PSGI/P6GI/P6W interface for web applications.

Despite being single threaded it can be relatively high performance with

appropriate tuning of the server configuration.

## Installation

You will need an HTTP server that supports FastCGI to be able to use this.

Assuming you have a working Rakudo installation then you should be able to insall it with *zef*

    zef install FastCGI::NativeCall::PSGI

    # Or from a local clone

    zef install .

## Support

I am probably not the right person to be asking about the configuration

of various server software to use FastCGI, you probably want to consult

the manuals in the first place.

Some parts of the support for the full P6GI/P6W spec may be incomplete

but this should be filled out over time.

In testing with [Siege](https://www.joedog.org/siege-home/) some

frameworks performed remarkably worse than others, if you have a concern

about the performance of your application please try to test with another

host server as it may be the framework rather than this module.

Please send suggests/patches etc to [github](https://github.com/jonathanstowe/raku-fcgi-psgi/issues)

## Copyright and Licence

This is free software. Please see the [LICENCE](LICENCE) file for details.

    Copyright (c) 2015, carlin 

                © 2017 - 2021 Jonathan Stowe