====== Gemini-PHP ======
A [[https://gemini.circumlunar.space/|Gemini]] server written in PHP.  This code is designed to be simple to understand (we'll use it in our socket programming workshops).  If you have any questions or want to get in touch, you can join our community on Matrix at **#gemini-php:glasgow.social**

Our offical Gemini page is **[[gemini://glasgow.social/gemini-php]]**

===== Download =====

You can [[https://coding.openguide.co.uk/gitweb/?p=gemini-php;a=summary|view the source]], download the [[https://coding.openguide.co.uk/gitweb/?p=gemini-php;a=snapshot;h=HEAD;sf=tgz|latest tarball]] or git clone it via:
<code bash>
git clone https://coding.openguide.co.uk/git/gemini-php/
</code>

===== Getting Started =====
  * Clone the repository
<code bash>
git clone https://coding.openguide.co.uk/git/gemini-php/
</code>
  * Enter the project directory and create a certificate for your server (a self signed certificate is fine, in fact it's encouraged!)
<code bash>
cd gemini-php
openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365
</code>
  * Combine your private key with the certificate and put it in the ''certs'' directory
<code bash>
cp cert.pem certs/combined.pem
cat key.pem >> certs/combined.pem
</code>
  * Create a config file
<code bash>
cp config.php.sample config.php
</code>
  * Then edit it with the location of your new certificate (''certs/combined.pem'') - most other options are optional
  * Start your server with:
<code bash>
php server.php
</code>
  * You should be able to visit your new server in any Gemini client (remember to open your firewall if needed [port 1965]).
  * The default file it serves (like an index.html) is at ''hosts/default/index.gemini''
  * We recommend [[https://github.com/skyjake/lagrange|Lagrange]] if you haven't settled on a Gemini client yet.