End of Life for Twilio Programmable Video - Upgrade to VideoSDKLearn More

how to integrate Socket.IO with PHP?

Learn how to integrate Socket.IO with PHP to build real-time web applications. This step-by-step guide includes practical examples, and code snippet.


In the era of dynamic and interactive web applications, real-time communication has become a cornerstone for creating engaging user experiences. Technologies like Socket.IO play a pivotal role in enabling this real-time interaction, allowing data to be transmitted instantly between clients and servers. When combined with PHP, one of the most popular server-side scripting languages, developers can leverage the strengths of both technologies to build robust, real-time web applications. This article will guide you through the process of integrating Socket.IO with PHP, providing a step-by-step tutorial along with practical examples to help you get started.

Getting Started with Socket.IO and PHP

To integrate Socket.IO with PHP, you need a basic understanding of PHP, Node.js, and JavaScript. You'll also need to set up your development environment with the necessary tools and libraries. This includes PHP, Node.js, Socket.IO, and Composer.


  • Basic knowledge of PHP, Node.js, and JavaScript
  • Installed tools: PHP, Node.js, and Composer

Tools and Libraries Required

  • PHP: Server-side scripting language
  • Node.js: JavaScript runtime for server-side programming
  • Socket.IO: Library for real-time web applications
  • Composer: Dependency manager for PHP

Setting Up the Development Environment

  • Ensure PHP and Composer are installed.
  • Install Node.js and Socket.IO as described in the next steps.

Step 1: Installing Node.js and Socket.IO

First, you need to install Node.js, which will serve as the environment for running your Socket.IO server.

Install Node.js

Download and install Node.js from



Install Socket.IO

Open your terminal and run the following command to install Socket.IO using npm (Node Package Manager):


1   npm install socket.io
This command will install the Socket.IO library and its dependencies.

Step 2: Setting Up a Basic Node.js Server

Next, set up a basic Node.js server that will use Socket.IO to handle real-time connections.

Create a Node.js Server

Create a new file named server.js and add the following code to set up a basic server:


1   const app = require('express')();
2   const http = require('http').createServer(app);
3   const io = require('socket.io')(http);
5   app.get('/', (req, res) => {
6       res.send('<h1>Hello world</h1>');
7   });
9   io.on('connection', (socket) => {
10       console.log('a user connected');
11   });
13   http.listen(3000, () => {
14       console.log('listening on *:3000');
15   });

Run the Server

In your terminal, navigate to the directory containing server.js and run:


1   node server.js
Your Node.js server is now running and ready to accept connections.

Step 3: Integrating PHP with Socket.IO

To allow your PHP application to communicate with the Node.js server, you need to set up the necessary PHP libraries.

Install PHP Libraries

Use Composer to install the ZeroMQ library, which facilitates communication between PHP and the Node.js server.


1   composer require mlocati/php-zmq

Set Up Communication

Create a PHP script that sends messages to the Node.js server. Save this as send_message.php:


1   <?php
2   require 'vendor/autoload.php';
4   $message = 'Hello from PHP';
5   $context = new ZMQContext();
6   $socket = $context->getSocket(ZMQ::SOCKET_PUSH, 'my pusher');
7   $socket->connect('tcp://localhost:5555');
8   $socket->send($message);
9   ?>

Update Node.js Server

Modify your server.js to handle messages from PHP:


1   const zmq = require('zeromq');
2   const receiver = zmq.socket('pull');
4   receiver.bindSync('tcp://*:5555');
5   receiver.on('message', function(msg) {
6       console.log('Received message from PHP: ' + msg.toString());
7       io.emit('message', msg.toString());
8   });
This configuration allows your PHP script to push messages to the Node.js server, which will then broadcast them to all connected clients via Socket.IO.

Step 4: Establishing Real-Time Communication

Now that your PHP and Node.js servers are set up to communicate, it's time to establish real-time communication between them and the clients.

Set Up Event Listeners

In server.js, ensure that the server listens for messages from PHP and broadcasts them to clients:


1   io.on('connection', (socket) => {
2       console.log('a user connected');
3       socket.on('disconnect', () => {
4           console.log('user disconnected');
5       });
6   });
8   receiver.on('message', function(msg) {
9       io.emit('message', msg.toString());
10   });

Client-Side Codea

Create a simple HTML file, index.html, to connect to the Socket.IO server and display messages:


1   <!DOCTYPE html>
2   <html>
3   <head>
4       <title>Socket.IO PHP Example</title>
5       <script src="/socket.io/socket.io.js"></script>
6       <script>
7           var socket = io();
8           socket.on('message', function(msg){
9               var li = document.createElement("li");
10               li.appendChild(document.createTextNode(msg));
11               document.getElementById("messages").appendChild(li);
12           });
13       </script>
14   </head>
15   <body>
16       <ul id="messages"></ul>
17   </body>
18   </html>

Run PHP Script

Execute the send_message.php script to send a message to the Node.js server, which will then broadcast it to connected clients.


1   php send_message.php
Your clients connected to the Node.js server will now receive real-time messages sent from your PHP script.

Step 5: Handling Real-Time Events in PHP

To handle real-time events in PHP, you can use the Ratchet library, which provides WebSocket capabilities.

Install Ratchet

Use Composer to install Ratchet:


1   composer require cboden/ratchet

Set Up WebSocket Server

Create a new PHP file, websocket_server.php, and add the following code:


1   <?php
2   use Ratchet\MessageComponentInterface;
3   use Ratchet\ConnectionInterface;
5   require 'vendor/autoload.php';
7   class Chat implements MessageComponentInterface {
8       public function onOpen(ConnectionInterface $conn) {
9           echo "New connection! ({$conn->resourceId})\n";
10       }
12       public function onMessage(ConnectionInterface $from, $msg) {
13           echo "Message received: {$msg}\n";
14       }
16       public function onClose(ConnectionInterface $conn) {
17           echo "Connection {$conn->resourceId} has disconnected\n";
18       }
20       public function onError(ConnectionInterface $conn, \Exception $e) {
21           echo "An error has occurred: {$e->getMessage()}\n";
22           $conn->close();
23       }
24   }
26   $server = IoServer::factory(
27       new HttpServer(
28           new WsServer(
29               new Chat()
30           )
31       ),
32       8080
33   );
35   $server->run();
36   ?>

Run WebSocket Server

In your terminal, run the WebSocket server:


1   php websocket_server.php
Your PHP application can now handle real-time WebSocket connections, enabling interactive communication with clients.

Step 6: Testing and Debugging

Testing and debugging are crucial to ensure your real-time application works seamlessly.


  • Open multiple browser tabs and connect them to your Socket.IO server to test real-time message broadcasting.
  • Execute your PHP script to send messages and observe the updates in real-time across all connected clients.

Common Issues

  • Connection Refused: Ensure your Node.js server is running and listening on the correct port.
  • Message Not Received: Check for typos in event names and ensure your PHP script is properly connected to the Node.js server.

Debugging Tools

  • Use browser developer tools to monitor WebSocket connections and messages.
  • Add logging statements in your Node.js and PHP scripts to trace the flow of messages and identify issues.
By following these steps and utilizing the provided code snippets, you can successfully integrate Socket.IO with PHP to create real-time web applications.

Get Free 10,000 Minutes Every Months

No credit card required to start.


Integrating Socket.IO with PHP allows developers to build powerful, real-time web applications that enhance user interaction. By following this guide, you can set up a robust communication system between your PHP backend and clients using Node.js and Socket.IO, providing seamless real-time experiences for your users.

Want to level-up your learning? Subscribe now

Subscribe to our newsletter for more tech based insights