NAME
cgi_this - export the current directory as if it were a cgi-bin
VERSION
version 0.005
SYNOPSIS
## Export the current directory like a cgi-bin
$ cgi_this
## Export the dir_name directory like a cgi-bin
$ cgi_this dir_name
## Start the server on a specific port
$ cgi_this --port 9001
## Set HTTP server to listen for incoming connections on 192.168.0.1
$ cgi_this --host 192.168.0.1
## Announces the HTTP server via Bonjour with the specified name
$ cgi_this --name "My CGI server"
## Inlcude /cgi-bin in your URL
$ cgi_this --cgi-bin
## Show documentation about our options
$ cgi_this --help
## Show the entire man page
$ cgi_this --man
DESCRIPTION
Like http_this and https_this, but converts the directory to a cgi-bin
and runs every script in it as a CGI script. This is useful for testing old CGI scripts when you don't have a web server installed.
OPTIONS
The following options are available:
- --port PORT
-
Start the HTTP server on a specific
PORT
. Default is 3000. - --host IP_ADDRESS
-
Set HTTP server to listen for incoming connections on
IP_ADDRESS
. Default is 127.0.0.1. - --name NAME
-
Announces the server over Bonjour.
This feature requires the Net::Rendezvous::Publish module and the appropriate backend for your operating system, both available from CPAN. If one of them cannot be found, a warning message will be displayed.
- --cgi-bin
-
Include the
/cgi-bin
directory in the URL of your scripts. For the cozy legacy feeling. - --help
-
Print information about the script usage and its options.
- --man
-
Print the entire man page for the command.
EXAMPLES
The t/
directory of this distribution contains a few examples. Here is how to use them.
$ cgi_this t
Exporting 't', available at:
http://127.0.0.1:3000/
Found the following scripts:
http://127.0.0.1:3000/test-no-bin.cgi
http://127.0.0.1:3000/bin/test.pl
At this point you can visit the URLs in your browser and see the scripts in action.
If want some nostalgia, enable the --cgi-bin
option. It will stick a fake /cgi-bin
in the URL.
$ cgi_this --cgi-bin t
Exporting 't', available at:
http://127.0.0.1:3000/
Found the following scripts:
http://127.0.0.1:3000/cgi-bin/test-no-bin.cgi
http://127.0.0.1:3000/cgi-bin/bin/test.pl
SEE ALSO
At the the Swiss Perl Workshop in 2018 Julien gave a talk about this and similar modules, titled "Do stuff with _this". You can find a recording here.
AUTHOR
simbabque <simbabque@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2017 by simbabque.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.