Skip to content

Commit 0245454

Browse files
committed
optimize comments
1 parent 1ef917a commit 0245454

File tree

3 files changed

+30
-39
lines changed

3 files changed

+30
-39
lines changed

README.md

Lines changed: 20 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ php -S 127.0.0.1:9001 -t .
2727
![Demo](https://raw.githubusercontent.com/hhxsv5/SSE/master/sse.png)
2828

2929
### Javascript demo
30-
>Client: receiving events from the server
30+
> Client: receiving events from the server.
3131
3232
```Javascript
3333
//withCredentials=true: pass the cross-domain cookies to server-side
@@ -38,59 +38,55 @@ source.addEventListener("new-msgs", function(event){
3838
```
3939

4040
### PHP demo
41-
>Server: sending events from the server by pure php
41+
> Server: sending events from the server by pure php.
4242
4343
```PHP
44-
include './vendor/autoload.php';
44+
include '../vendor/autoload.php';
4545

4646
use Hhxsv5\SSE\SSE;
4747
use Hhxsv5\SSE\Update;
4848

49+
// Example: push messages to client
50+
4951
header('Content-Type: text/event-stream');
5052
header('Cache-Control: no-cache');
5153
header('Connection: keep-alive');
52-
header('X-Accel-Buffering: no');//Nginx: unbuffered responses suitable for Comet and HTTP streaming applications
54+
header('X-Accel-Buffering: no'); // Nginx: unbuffered responses suitable for Comet and HTTP streaming applications
5355

5456
(new SSE())->start(new Update(function () {
5557
$id = mt_rand(1, 1000);
56-
$newMsgs = [
57-
[
58-
'id' => $id,
59-
'title' => 'title' . $id,
60-
'content' => 'content' . $id,
61-
],
62-
];//get data from database or service.
63-
if (!empty($newMsgs)) {
64-
return json_encode(['newMsgs' => $newMsgs]);
58+
$news = [['id' => $id, 'title' => 'title ' . $id, 'content' => 'content ' . $id]]; // Get news from database or service.
59+
if (!empty($news)) {
60+
return json_encode(compact('news'));
6561
}
66-
return false;//return false if no new messages
67-
}), 'new-msgs');
62+
return false; // Return false if no new messages
63+
}), 'news');
6864
```
6965

7066
### Symfony and Laravel demo
71-
>Server: sending events from the server by Laravel or Symfony
67+
> Server: sending events from the server by Laravel or Symfony.
7268
7369
```PHP
7470
use Hhxsv5\SSE\SSE;
7571
use Hhxsv5\SSE\Update;
7672

77-
//Action method in the controller
78-
public function newMsgs()
73+
// Action method in controller
74+
public function getNewsStream()
7975
{
8076
$response = new \Symfony\Component\HttpFoundation\StreamedResponse();
8177
$response->headers->set('Content-Type', 'text/event-stream');
8278
$response->headers->set('Cache-Control', 'no-cache');
8379
$response->headers->set('Connection', 'keep-alive');
84-
$response->headers->set('X-Accel-Buffering', 'no');//Nginx: unbuffered responses suitable for Comet and HTTP streaming applications
80+
$response->headers->set('X-Accel-Buffering', 'no'); // Nginx: unbuffered responses suitable for Comet and HTTP streaming applications
8581
$response->setCallback(function () {
8682
(new SSE())->start(new Update(function () {
8783
$id = mt_rand(1, 1000);
88-
$newMsgs = [['id' => $id, 'title' => 'title' . $id, 'content' => 'content' . $id]];//get data from database or service.
89-
if (!empty($newMsgs)) {
90-
return json_encode(['newMsgs' => $newMsgs]);
84+
$news = [['id' => $id, 'title' => 'title ' . $id, 'content' => 'content ' . $id]]; // Get news from database or service.
85+
if (!empty($news)) {
86+
return json_encode(compact('news'));
9187
}
92-
return false;//return false if no new messages
93-
}), 'new-msgs');
88+
return false; // Return false if no new messages
89+
}), 'news');
9490
});
9591
return $response;
9692
}

examples/push.html

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,9 @@
55
</head>
66
<body>
77
<h1>SSE example</h1>
8-
<div id="result"></div>
9-
<script>
8+
<div id="news-list"></div>
9+
<script type="application/javascript">
10+
var newsList = document.getElementById('news-list');
1011
if (typeof (EventSource) !== 'undefined') {
1112
var source = new EventSource('/push.php');
1213
source.onopen = function (event) {
@@ -16,13 +17,13 @@ <h1>SSE example</h1>
1617
console.log('onerror', event);
1718
};
1819
// source.onmessage = function(event) {
19-
// document.getElementById('result').innerHTML += event.data + '<br />';
20+
// newsList.innerHTML += event.data + '<br />';
2021
// };
21-
source.addEventListener('new-msgs', function (event) {
22-
document.getElementById('result').innerHTML += event.data + '<br />';
22+
source.addEventListener('news', function (event) {
23+
newsList.innerHTML += event.data + '<br />';
2324
});
2425
} else {
25-
document.getElementById('result').innerHTML = 'Sorry, your browser does not support server-sent events...';
26+
newsList.innerHTML = 'Sorry, your browser does not support server-sent events...';
2627
}
2728
</script>
2829
</body>

examples/push.php

Lines changed: 3 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -13,15 +13,9 @@
1313

1414
(new SSE())->start(new Update(function () {
1515
$id = mt_rand(1, 1000);
16-
$news = [
17-
[
18-
'id' => $id,
19-
'title' => 'title #' . $id,
20-
'content' => 'content #' . $id,
21-
],
22-
]; // Get news from database or service.
16+
$news = [['id' => $id, 'title' => 'title ' . $id, 'content' => 'content ' . $id]]; // Get news from database or service.
2317
if (!empty($news)) {
24-
return json_encode(['news' => $news]);
18+
return json_encode(compact('news'));
2519
}
26-
return false;// Return false if no new messages
20+
return false; // Return false if no new messages
2721
}), 'news');

0 commit comments

Comments
 (0)