egroupware / swoolepush
EGroupware push server using Swoole
Installs: 16 686
Dependents: 1
Suggesters: 0
Security: 0
Stars: 2
Watchers: 4
Forks: 0
Type:egroupware-app
Requires
- easyswoole/memcache-pool: ^1.0
- egroupware/exception: ^2.1.0
- egroupware/hstream: ^1.7.0
- egroupware/idna: ^1.2.0
- egroupware/listheaders: ^1.3.0
- egroupware/mail: ^2.7.0
- egroupware/mime: ^2.13.0
- egroupware/stream-filter: ^2.1.0
- egroupware/stream-wrapper: ^2.2.0
- egroupware/support: ^2.3.0
- egroupware/text-flowed: ^2.1.0
- egroupware/translation: ^2.3.0
- egroupware/util: ^2.7.0
Requires (Dev)
- eaglewu/swoole-ide-helper: dev-english
- dev-master
- 23.1.20241111
- 23.1.20241008
- 23.1.20240930
- 23.1.20240905
- 23.1.20240624
- 23.1.20240430
- 23.1.20240304
- 23.1.20240125
- 23.1.20231220
- 23.1.20231219
- 23.1.20231201
- 23.1.20231129
- 23.1.20231122
- 23.1.20231110
- 23.1.20230911
- 23.1.20230824
- 23.1.20230728
- 23.1.20230726
- 23.1.20230620
- 23.1.20230524
- 23.1.20230503
- 23.1.20230428
- 23.1.20230412
- 23.1.20230328
- 23.1.20230314
- 23.1.20230228
- 23.1.20230210
- 23.1.20230125
- 23.1.20230114
- 23.1.20230110
- 23.1.x-dev
- 22.1.20220920
- 21.1.20230210
- 21.1.20221202
- 21.1.20220916
- 21.1.20220905
- 21.1.20220408
- 21.1.20220406
- 21.1.20220207
- 21.1.20211130
- 21.1.20210923
- 21.1.20210723
- 21.1.20210629
- 21.1.20210521
- 21.1.20210504
- 21.1.20210420
- 21.1.20210406
- 21.1.20210329
- 21.1.20210318
- 21.1.x-dev
- 20.1.20210503
- 20.1.20210324
- 20.1.20210125
- 20.1.20201217
- 20.1.20201202
- 20.1.20201028
- 20.1.20201020
- 20.1.20201005
- 20.1.20200914
- 20.1.20200901
- 20.1.20200818
- 20.1.20200812
- 20.1.20200810
- 20.1.20200731
- 20.1.20200728
- 20.1.20200716
- 20.1.20200710
- 20.1.20200628
- 20.1.20200613
- 20.1.20200525
- 20.1.x-dev
- dev-milan
This package is auto-updated.
Last update: 2024-11-25 17:47:12 UTC
README
Open tasks:
- check session matches HTTP host / instance AND session is not anonymous
- rotate token by async job and push new tokens to active sessions
- require Bearer token to authorize requests / send push messages
- check sessionid cookie when client opens a websocket connection
Installation instructions
Most easy installation is the one comming with the container based development system.
To install EGroupwares push server for a regular webserver running on the host follow these instructions:
cd /path/to/egroupware
git clone git@github.com:EGroupware/swoolpush.git
cd swoolpush
docker run --rm -it -v $(pwd):/var/www -v /var/lib/php/sessions:/var/lib/php/sessions -p9501:9501 phpswoole/swoole
You need to adapt the session-directory, if you are not using Ubuntu.
Then visit setup and install swoolpush app (no run rights for users neccessary).
You need to proxy the /push URL into the container, eg. for Apache
<Location /egroupware/push>
Order allow,deny
Allow from all
RewriteEngine On
RewriteCond %{HTTP:Upgrade} =websocket [NC]
RewriteRule /var/www/(.*) ws://localhost:9501/$1 [P,L]
RewriteCond %{HTTP:Upgrade} !=websocket [NC]
RewriteRule /var/www/(.*) http://localhost:9501/$1 [P,L]
ProxyPreserveHost On
ProxyPassReverse http://localhost:9501
</Location>
You need to change the above /var/www, in case you use a different document root.
eg. for Nginx
location /egroupware/push {
proxy_http_version 1.1;
proxy_set_header Host $http_host;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";
proxy_pass http://localhost:9501;
}
Send a test-message
You can get a token from the server output, when a client connects.
curl -i -H 'Content-Type: application/json' -X POST 'https://boulder.egroupware.org/egroupware/push?token=<token>' \
-d '{"type":"message","data":{"message":"Hi ;)","type":"notice"}}'
Remember you need to restart the Docker container, when you make changes to the server!