💾 Archived View for seydaneen.nahtgards.de › leuchtturm › dwemerartefakte › jags-php captured on 2023-04-26 at 13:21:36. Gemini links have been rewritten to link to archived content
-=-=-=-=-=-=-
A simple easy to understand and extendable single PHP-Class socket server written in PHP.
JAGS is based of Gemini-PHP by @neil:glasgow.social (Matrix). You can read more about it at:
gemini://glasgow.social/gemini-php
Date Version Changes 2022-04-21 202204_1 support for file handlers 2022-02-04 202202_3 default files for subdirectories, more than one default file 2022-02-04 202202_2 security fix 2022-02-03 202202_1 Multiple (sub) domains 2021-09-11 202109_1 fixed bug for serving files that are bigger than ~100kb 2021-04-28 202104_1 bugfix for high cpu load 2021-02-25 202102_4 bugfix for path params, try/catch for external php scripts, better get params translation, better logging 2021-02-23 202102_2 log cleanup added, more documentation 2021-02-22 202102_1 first release
1. git clone this repository (or download a zipped snapshot)
2. create a new ssl certificate for your host with openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes
3. concet the key and cert to one file with cp cert.pem certs/yourdomain.com.pem; cat key.pem >> certs/yourdomain.com.pem
4. copy config.sample.php to config.php
5. configure your hosts in line 49
6. run the server with php server.php
For more details look at the comments in config.sample.php, server.php and the files in the hosts/default directory.
- Check the changes in the config.sample.php. With the new hosts-Array you need to reconfigure your server
- If you use a certificate with pass phrase you must replace it with one certificate without password.
The server looks for PHP scripts and runs them with include. All your scripts echo (...) will returned to the client as text/gemini mime type.
If you want to check the request data, for example for get params or auth informations you can do this with the $JAGSRequest array inside your script:
[ 'host' => '...', 'scheme' => 'gemini', 'path' => '/dynamic.php', 'query' => '...', 'get' => [], 'auth' => false, 'file_path' => '...', ]
It's the result of parse_url() with a extra array for get-params, auth informations by openssl_x509_parse() and the absolute path to the current file.
To manipulate the return data check the $JAGSReturn array:
[ 'content' => false, 'status_code' => '20', 'meta' => 'text/gemini', 'file_size' => 0, ]
file_size will be automatically calculated based on content, which will be filled with all stuff you echo in your PHP script.
If you want virtual paths you could just place a PHP named for example dynamic.php and open /dynamic/myparam1/myparam2=2?param3=test in your Gemini browser. The result in $JAGREQUEST is following:
[
//...
'path' => '/dynamic.php',
'query' => 'param3=test&myparam1&myparam2=2',
'get' => [
'param3' => 'test',
1 => 'myparam1',
'myparam2' => '2',
],
//...
]
Notice: "myparam1" will be added as indexed param.
You have found a bug or have questions? Contact me on Matrix: @scops:tchncs.de