Configuration of Mini Thing PHP Gopher & Proxy Server!

The script provides a flexible configuration system balancing
functionality and security.

Default technical specifications:

- PHP 8+, UTF-8, NO JS and SQL!
- Maximum download file size: 500KB
- Allowed extensions: txt, gif, jpg, png, html
- Connection timeout: 30 seconds
- Protection against local path traversal (../ and ./ are removed)
- Your gophermap uses settings identical to the Motsognir
server, so read the PDF manual!

Configuration Recommendations:

- For public servers, use strict restrictions;
- For local use, restrictions can be relaxed;
- Monitor logs for suspicious requests;
- Regularly update the list of allowed extensions;
- Test with various Gopher resources;

Configuration instructions:

1. Security settings:

public function __construct(
    int $maxFileSize = 102400, // Maximum file size (100KB)
    array $allowedExtensions = [ // Allowed file extensions
        'txt', 'gif', 'jpg', 'png', 'html'
    ], 
    int $timeout = 30 // Connection timeout (seconds)
)

2. Setting maximum file size

// Example: increase limit to 5MB
$proxy = new GopherProxy(5 * 1024 * 1024);

3. Configuring allowed extensions

// Example: add support for PDF and MP3
$proxy = new GopherProxy(102400, ['txt', 'gif', 'jpg', 'png', 'html', 'pdf', 'mp3']);

4. Setting timeout

// Example: reduce timeout to 10 seconds
$proxy = new GopherProxy(102400, ['txt', 'gif', 'jpg', 'png', 'html'], 10);

5. Base content directory

$renderer = new GophermapRenderer(__DIR__);
// or for another directory
$renderer = new GophermapRenderer('/var/www/gopher');

6. Security customization:

Strict security policy:

$strictProxy = new GopherProxy(
    51200,                          // 50KB maximum
    ['txt'],                        // Only text files
    5                               // 5 seconds timeout
);

Liberal policy (use with caution!):

$liberalProxy = new GopherProxy(
    10 * 1024 * 1024,              // 10MB maximum
    ['txt', 'gif', 'jpg', 'png', 'html', 'pdf', 'mp3', 'mp4'],
    60                              // 60 seconds timeout
);