diff options
author | Minteck <46352972+Minteck@users.noreply.github.com> | 2021-05-01 18:05:04 +0200 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-05-01 18:05:04 +0200 |
commit | 6bce445b3351d224ff3e3953789ff4a5e5c858d5 (patch) | |
tree | ec9bc72c1b94c5ac3d511bb8fc91d31f24db7fed | |
parent | 981b80066504cf94224f0fd431281edb740f2669 (diff) | |
download | electrode-6bce445b3351d224ff3e3953789ff4a5e5c858d5.tar.gz electrode-6bce445b3351d224ff3e3953789ff4a5e5c858d5.tar.bz2 electrode-6bce445b3351d224ff3e3953789ff4a5e5c858d5.zip |
Update README.md
-rw-r--r-- | README.md | 80 |
1 files changed, 32 insertions, 48 deletions
@@ -1,48 +1,32 @@ -# FNS Electrode, a NodeJS webserver for PHP applications - -Electrode is a NodeJS webserver with a PHP subsystem. Electrode can serve static files as fast as possible, and run on-demand PHP scripts. - -Electrode is meant to be fast, reliable and unattended (it will automatically update an installed software when needed). Electrode is made to be used with FNS Neutron, but can also (but not recommended to) be used with other software. - -> Electrode and Neutron can only work on Linux servers. To use it on Windows servers, please use WSL 2 and follow instructions in [Windows Setup](#windows-setup) - -## Getting started -The first time you need to run Electrode, you'll need to compile some dependencies: -```plaintext -npm rebuild -``` - -When you compiled the dependencies, you can start Electrode using NPM: -```plaintext -npm start -``` - -... or using NodeJS -```plaintext -node index.js -``` - -Electrode will start in threaded mode (one thread per CPU core) for optimal performance. - -> **Important :** There's a `cache` folder, **NEVER DELETE ITS CONTENT** or it will break PHP scripts. Files in the `cache` folder are automatically deleted by Electrode. - -## Requirements -* NodeJS 12 or newer -* PHP 7.4 or newer -* The `xdebug` extension (used to get the response headers from PHP) -* `make` and all development libraries -* The NPM package manager - -## Windows Setup -As said earlier, Electrode and Neutron can't run on Windows servers. If you want to use a Windows server, you can use WSL. - -> Before continuing, please note that using a Windows server in a production environement is really discouraged, as Neutron asn't been extensively tested through WSL. - -1. First, [install WSL](https://docs.microsoft.com/en-us/windows/wsl/install-win10) by following the Microsoft documentation -> Don't miss the part about upgrading to WSL 2, it is VERY important -2. Install `php` (version 7.4 or later), `php-xdebug`, `php-gd`, `nodejs` (version 12 or later), `npm`, `make`, `cmake`, `wget` and `zip`. -> On Debian or Ubuntu, you would install with -> -> ```sudo apt install php php-xdebug php-gd nodejs npm make cmake build-essential wget zip``` -3. Download and extract Electrode on your WSL -4. Follow the instructions in [Getting started](#getting-started)
\ No newline at end of file +<p align="center"> + <img src="https://user-images.githubusercontent.com/46352972/116787979-7ee30680-aaa7-11eb-8a86-2b3829574dab.png" width="64px" /><br> + <big>ยป<b> FNS Electrode </b>ยซ</big> + <br>developed with<br> + <img src="https://user-images.githubusercontent.com/46352972/116787437-47268f80-aaa4-11eb-99c9-a771eb7dadcc.png" width="48px"> +</p> + +---- + +A fast and powerful NodeJS web server for FNS Neutron. + +* **Status:** ๐ป Actively maintained +<!-- * **Status:** ๐ Extended maintenance --> +<!-- * **Status:** ๐ด Searching for mainteners --> +<!-- * **Status:** ๐ซ Archived, **DO NOT USE IN PRODUCTION** --> + +## Summary +* **Language:** JavaScript +* **Started:** December 2020 +* **License:** GNU General Public License 3.0 +* **Website:** https://mpcms.rf.gd + +## Setup +* Install `nodejs`, `npm`, `make`, `cmake`, `wget`, `zip`, `php`, `php-xdebug`, `php-gd` +* Clone the repository +* Install everything: `npm install` +* Set the listen port in the `/config/network.json` file +* Start: `npm start` +* Open your web browser to the port specified in the config + +## Issues +Issues are reported either on [Minteck Projects' bug tracker](https://mpbugger.alwaysdata.net) or using GitHub issues. |