Download the PHP package exodus4d/pathfinder_websocket without Composer

WebSocket server for Pathfinder

Requirements

• PHP (≥ v7.1)
• A working instance of Pathfinder (≥ v2.0.0-rc.1)
• Composer to install packages for the WebSocket server

Install

1. Checkout this project in a new folder e.g. /var/www/websocket.pathfinder
2. Install Composer
3. Install Composer dependencies from composer.json file:
   • $ cd /var/www/websocket.pathfinder
   • $ composer install
4. Start WebSocket server $ php cmd.php

Configuration

Default

Clients (WebBrowser) listen for connections

• Host: 0.0.0.0. (=> any client can connect)
• Port: 8020
• ↪ URI: 127.0.0.1:8020

(=> Your WebServer (e.g. Nginx) should proxy all WebSocket connections to this source)

TCP TcpSocket connection (Internal use for WebServer ⇄ WebSocket server communication)

• Host: 127.0.0.1 (=> Assumed WebServer and WebSocket server running on the same machine)
• Port: 5555
• ↪ URI: tcp://127.0.0.1:5555

(=> Where Pathfinder reaches the WebSocket server. This must match SOCKET_HOST, SOCKET_PORT options in environment.ini)

Start parameters [Optional]

The default configuration should be fine for most installations. You can change/overwrite the default Host and Port configuration by adding additional CLI parameters when starting the WebSocket server:

$ php cmd.php --wsHost [CLIENTS_HOST] --wsPort [CLIENTS_PORT] --tcpHost [TCP_HOST] --tcpPort [TCP_PORT] --debug 0

For example: If you want to change the the WebSocket port and increase debug output:

$ php cmd.php --wsPort 8030 --debug 3

--debug (default --debug 2)

Allows you to set log output level from 0 (silent) - errors are not logged, to 3 (debug) for detailed logging.

WebSocket UI

There is a WebSocket section on Pathinders /setup page. After the WebSocket server is started, you should check it if everything works. You see the most recent WebSocket log entries, the current connection state, the current number of active connections and all maps that have subscriptions

Log entry view. Depending on the --debug parameter, the most recent (max 50) entries will be shown:

Subscriptions for each map:

Unix Service (systemd)

New Service

It is recommended to wrap the cmd.php script in a Unix service, that over control the WebSocket server. This creates a systemd service on CentOS7:

1. $ cd /etc/systemd/system
2. $ vi websocket.pathfinder.service
3. Copy script and adjust ExecStart and WorkingDirectory values:

Now you can use the service to start/stop/restart your WebSocket server

• $ systemctl start websocket.pathfinder.service
• $ systemctl restart websocket.pathfinder.service
• $ systemctl stop websocket.pathfinder.service

Auto-Restart the Service

You can automatically restart your service (e.g. on EVE-Online downtime). Create a new "timer" for the automatic restart.

1. $ cd /etc/systemd/system (same dir as before)
2. $ vi restart.websocket.pathfinder.timer
3. Copy script:

Now we need a new "restart service" for the timer:

1. $ cd /etc/systemd/system (same dir as before)
2. $ vi restart.websocket.pathfinder.service
3. Copy script:

And then, we need to either restart the machine or launch

Info

• Ratchet - "WebSockets for PHP"
• ReactPHP - "Event-driven, non-blocking I/O with PHP"