mp-php/fuel-packages-ratchet

fuel-packages-ratchet

• WebSocket Server by Ratchet
• ZeroMQ is required
• Samples

Install ZeroMQ

• Linux
• Mac OS X
• Windows

Install

Setup to fuel/packages/ratchet

• Use composer https://packagist.org/packages/mp-php/fuel-packages-ratchet
• git submodule add
• Download zip

If you use git submodule or download zip, you must install vendors, _(*1)

$ cd fuel/packages/ratchet
$ php composer.phar install

Configuration

In app/config/config.php, _(*2)

'always_load' => array('packages' => array(
    'ratchet',
    ...

Copy packages/ratchet/config/ratchet.php to under app/config directory and edit, _(*3)

<?php

return array(
    'classes' => array(
        'default' => array(
            'domain' => 'example.com',
            'port' => '8001',
            'zmq_port' => '5555',
        ),
        'Ratchet_Ws' => array(
            'domain' => 'example.com',
            'port' => '8001',
        ),
        'Ratchet_Wamp' => array(
            'domain' => 'example.com',
            'port' => '8002',
            'zmq_port' => '5555',
        ),
    ),
);

Usage

$ php oil r ratchet:help

Run with Supervisor

# Install with easy_install command
$ sudo easy_install supervisor

# Generate configure file
$ echo_supervisord_conf > fuel/packages/ratchet/supervisor.conf

Example for supervisor.conf

Add the following
My_Ratchet_Ws is fuel/app/classes/my/ratchet/ws.php that extends Ratchet_Ws, _(*4)

[program:ratchet]
environment             = FUEL_ENV=production
command                 = php oil r ratchet:ws My_Ratchet_Ws
numprocs                = 1
autostart               = true
autorestart             = true
user                    = root
stdout_logfile          = fuel/app/logs/supervisor/info.log
stdout_logfile_maxbytes = 1MB
stderr_logfile          = fuel/app/logs/supervisor/error.log
stderr_logfile_maxbytes = 1MB

Example Commands

# In FuelPHP project root

# Up
$ sudo supervisord -c fuel/packages/ratchet/supervisor.conf

# Check Status
$ sudo supervisorctl -c fuel/packages/ratchet/supervisor.conf status

# Stop
$ sudo supervisorctl -c fuel/packages/ratchet/supervisor.conf stop all

# Start
$ sudo supervisorctl -c fuel/packages/ratchet/supervisor.conf start all

# Restart
$ sudo supervisorctl -c fuel/packages/ratchet/supervisor.conf restart all

Example Commands with Makefile

# make up
up:
    @echo 'Please manually run the following command:'
    @echo 'sudo supervisord -c fuel/packages/ratchet/supervisor.conf'

# make down
down:
    sudo supervisorctl -c fuel/packages/ratchet/supervisor.conf stop all && sudo rm /tmp/supervisor.sock

# make start-all
start-all:
    sudo supervisorctl -c fuel/packages/ratchet/supervisor.conf start all

# make stop-all
stop-all:
    sudo supervisorctl -c fuel/packages/ratchet/supervisor.conf stop all

# make restart-all
restart-all:
    sudo supervisorctl -c fuel/packages/ratchet/supervisor.conf restart all

# make status
status:
    sudo supervisorctl -c fuel/packages/ratchet/supervisor.conf status

# make help
help:
    @echo 'Commands:'
    @echo '  make up'
    @echo '  make down'
    @echo '  make start-all'
    @echo '  make stop-all'
    @echo '  make restart-all'
    @echo '  make status'

License

Copyright 2013, Mamoru Otsuka. Licensed under the MIT license: http://www.opensource.org/licenses/mit-license.php, _(*5)