The number of listen queue.
The configuration is an integer representing the number of pending connections that waits for accept.
Set the output buffer size in the memory.
The default value is 2M. The data to send can't be larger than buffer_output_size every times.
$server->set([
'buffer_output_size' => 32 * 1024 *1024, // byte in unit
])
Redirect the root path of worker process.
This configuration is to separate the operation to the file system in the worker process from the real file system.
$serv->set(array('chroot' => '/data/server/'));
Set the cpu core number to handle the interrupt.
array('cpu_affinity_ignore' => array(0, 1))
Daemonize the swoole server process.
If the value of daemonize is more than 1, the swoole server will be daemonized.
The program which wants to run long time must enable this configuration.
If the daemonize has been enabled, the standard output and error of the program will be redirected to logfile. And if the configuration of log_file hasn't been setted, the standard output and error of the program will be redirected to /dev/null.
After daemonizing the processes, the value of
CWDwill change and the relative path of file will be different. So it must use absolute path in the program.
If the configuration of dispatch_mode is 1 or 3, there may be some data that arrive to worker process after closing the connection.
In this situation, if discard_timeout_request is true, the worker process will discard these data or still procee these data.
Set the dispatch_func to dispatch the connection to the worker process.
The swoole server provides [five types of dispatch_mode. If the dispatch_mode can't meet your need, you can write C++ function or PHP function to realize customized dispatch strategy.
<?php
$serv->set(array(
'dispatch_func' => 'my_dispatch_function',
));
Once the
dispatch_funchas been setted, the configurationdispatch_modewould not work.If the function setted by
dispatch_func, the swoole will result in a fatal error.If the data dispatched is more than 8K,
dispatch_funccan get 0-8180 bytes data.
It is forbidden to add any blocking operation in the
dispatch_funcotherwise theReactorgroup would stop.
<?php
$serv->set(array(
'dispatch_func' => function ($serv, $fd, $type, $data) {
var_dump($fd, $type, $data);
return intval($data[0]);
},
));
Parameters:
$fd, the id number of client
$type, the type of data, 0: receive data from the client, 4: the connection with the client closes, 5: the connection with the client starts
$data, the data to dispatch
Return:
the return must be a integer between 0 and worker_num
In other extension, use swoole_add_function to register function to swoole
int dispatch_function(swServer *serv, swConnection *conn, swEventData *data);
int dispatch_function(swServer *serv, swConnection *conn, swEventData *data)
{
printf("cpp, type=%d, size=%d\n", data->info.type, data->info.len);
return data->info.len % serv->worker_num;
}
int register_dispatch_function(swModule *module)
{
swoole_add_function("my_dispatch_function", (void *) dispatch_function);
}
The mode of dispatching connections to worker process.
This parameter only works for the SWOOLE_PROCESS mode swoole_server.
1, polling mode. Dispatch the connection to the workers in sequence.
2, fixed mode(default value of dispatch_mode). Dispatch the connection to the worker according to the id number of connection. In this mode, the data from the same connection will be handled by the same worker process.
3, preemptive mode. The swoole will dispatch the connection to the unoccupied worker process.
4, ip mode. Dispatch the connection to the worker according to the ip of client. The dispatch algorithm is ip2long(ClientIP) % worker_num
5, uid mode. If the connection has been bound with a uid by swoole_server->bind, the swoole will dispatch the connection to the worker according to the uid. The dispatch algorithm is UID % worker_num. If you want to use a string as a uid, it should convert this string by crc32($uid)
stateless server: 3 is advised for synchronous and blocking server, 1 is advised for asynchronous and non-blocking server
stateful server: 2, 4, 5
If the
dispatch_modeis1or3, the event ofconnectandclosewill be shielded.
Enable the delay of receiving new connection.
Once enabled, the client which has been accepted would not be added to the EventLoop automaticlly and only trigger the callback function of the receive event.
The worker process needs to call $serv->confirm($fd) to confirm the connection manually and add the connection to the EventLoop.
<?php
// enable `enable_delay_receive`
$serv->set(array(
'enable_delay_receive' => true,
));
$serv->on("Connect", function ($serv, $fd, $reactorId) {
$serv->after(2000, function() use ($serv, $fd) {
// confirm connection and start process data
$serv->confirm($fd);
});
});
Enable the reuse of port.
Enable the event of close and close when the dispatch_mode is 1 or 3.
Set the group of worker and task worker process.
<?php
$serv->set(array('group' => 'www-data'));
This configuration heartbeat_check_interval is the interval of polling every TCP connection.
If the connection hasn't sent any data to the server in the last interval of heartbeat_check_interval, the connection will be closed.
The swoole server would not send the heartbeat packet to the client but only wait for the heartbeat packet from the client. The heartbeat check of swoole server only check the last time of sending data from the client. If the time exceeds heartbeat_check_interval, the connection between the server and the client will be closed.
This configuration which works with the heartbeat_check_interval stands for the max idle time of connection.
<?php
array(
'heartbeat_idle_time' => 600,
'heartbeat_check_interval' => 60,
);
Set the log path of swoole.
In the log file, there are some labels to distinguish the thread or process that output the log item.
# Master process
$ Manager process
* Worker process
^ Task worker process
If the log file has been mv or unlink, the log can't be recorded normally. In this situation, you can send SIGRTMIN
Set the level of log.
The log that is inferior to the log_level setted will not be recorded to log file.
<?php
$serv->set(array(
'log_level' => 1,
));
0 =>DEBUG // all the levels of log will be recorded
1 =>TRACE
2 =>INFO
3 =>NOTICE
4 =>WARNING
5 =>ERROR
The max number of connection the server could handle at the same time.
After exceed this limit, the swoole server will refuse the new coming connection.
max_connshould be less thanulimit -nmax_connshould be more than(serv->worker_num + SwooleG.task_worker_num) * 2 + 32the default value ofmax_connisulimit -nthe value ofmax_connshould not be too large and be setted according to the memory usage of server.
the number of max request the worker process could receive.
The dafault value of max_request is 0 which means there is no limit of the max request. If the max_request is setted to some number, the worker process will exit and release all the memory amd resouce occupied by this process after receiving the max_request request. And then, the manager will respawn a new worker process.
This parameter is to resolve the problem of nonlocalizable and slow memory leak.
max_requestonly works for synchronous, blocking and stateless reponse program The totally asynchronous server should not setmax_requestmax_requestonly works forSWOOLE_PROCESSmode.
<?php
$serv = new swoole_server("127.0.0.1", 9501);
$serv->set(array(
'worker_num' => 2,
'max_request' => 3,
'dispatch_mode'=>3,
));
$serv->on('receive', function ($serv, $fd, $from_id, $data) {
$serv->send($fd, "Server: ".$data);
});
$serv->start();
Check the pid of worker process before request and after many times request.
Set the key of message queue.
This configuration only works if the configuration of task_ipc_mode has been setted to 2 or 3.
The default value of message_queue_key is calculated by ftok($php_script_file, 1).
Open the affinity setting of cpu.
This configuration is to check the package eof. The package eof is setted by the configuration package_eof
If this configuration has been enabled, the swoole will check the end of data from the client. If the end of data from client is the string setted by package_eof, the swoole will send the data to the worker process otherwise the swoole will continue receive and joint the data from client.
array(
'open_eof_check' => true,
'package_eof' => "\r\n",
)
The above configuration example can be used for Memcache or POP protocal which ends by \r\n. Once setted, the worker process will receive one or serveral whole packages. In the worker process, you should use explode("\r\n", $data) split the data or set the configuration package_eof to split the data automatically.
Enable the split of data to package.
Once the configuration open_eof_check has been setted, the worker process will receive the data ending with the specified string. This data may contain one or serval whole package. In this situation, you can enable the open_eof_split to split the data to package automatically. And then the callback function onReceive will receive a whole package.
Enable the process of http2 protocal.
This configuration needs to compile swoole with --enable-http2
$serv->set(array('open_http2_protocol' => true));
Enable the process of http protocal.
Once this configuration has enabled, the callback function onReceive will receive a whole http package.
The swoole_http_server will enable this configuration automatically.
<?php
$serv->set(array('open_http_protocol' => true));
Open the check of package length.
If this configuration has enabled, the swoole will open the analysis of package which has fixed header and body. And the worker process will receive a whole package in the callback function onReceive.
This configuration should work with three other configurations.
Use some field in the header of package to stand for the length the package. The swoole supports 10 types of length. Check the full list in the configuration of package_length_type
The offset of the package to calculate the length of package.
0, the length stands for the length of header and body
N, this value stands for that the length of header is N and the length of package only contains the length of body.
The offset of value of length in the header
struct
{
uint32_t type;
uint32_t uid;
uint32_t length;
uint32_t serid;
char body[0];
}
The configuration designed from the above protocal design
<?php
$server->set(array(
'open_length_check' => true,
'package_max_length' => 81920,
'package_length_type' => 'N',
'package_length_offset' => 8,
'package_body_offset' => 16,
));
Enable the process of mqtt protocal.
Once this configuration has enabled, the swoole will analyze the mqtt package head and the callback function onReceive will receive a whole mqtt package.
<?php
$serv->set(array('open_mqtt_protocol' => true));
Open this configuration to close the Nagle algorithm.
Enable the process of websocket protocal.
The swoole will enable this configuration open_http_protocol automatically if the configuration open_websocket_protocol has been enabled.
The swoole_websocket_server will enable this configuration automatically.
<?php
$serv->set(array('open_websocket_protocol' => true));
Set the end string of package.
This configuration should work with open_eof_check.
The max length of this string is 8 bytes.
Set the function to check the length of package. The swoole supports the PHP function and C++ function.
The function returns an integer.
0, lack of data to joint a whole package
1, error data, the swoole will close the connection.
The length of package.
<?php
$serv = new swoole_server("127.0.0.1", 9501);
$serv->set(array(
'open_length_check' => true,
'dispatch_mode' => 1,
'package_length_func' => function ($data) {
if (strlen($data) < 8) {
return 0;
}
$length = intval(trim(substr($data, 0, 8)));
if ($length <= 0) {
return -1;
}
return $length + 8;
},
'package_max_length' => 2000000,
));
$serv->on('receive', function (swoole_server $serv, $fd, $from_id, $data){
var_dump($data);
echo "#{$serv->worker_id}>> received length=" . strlen($data) . "\n";
});
$serv->start();
The type of length. For now, the swoole supports 10 types.
The max length of package whose unit is byte.
Once the configuration open_length_check/open_eof_check/open_http_protocol has enabled, the internal of swoole will joint the data received from the client amd the data stores in the memory before recevicing the whole package. So to limit the usage of memory, it should set the package_max_length.
The file path which the master process id saves in.
<?php
$server->set(array(
'pid_file' => __DIR__.'/server.pid',
));
The pid of master process saves in the pid_file after the swoole server starts. And this file is deleted after the swoole server stops normally.
Set the buffer size of pipe.
<?php
$server->set([
'pipe_buffer_size' => 32 * 1024 *1024,
]);
the number of the reactor thread(for SWOOLE_BASE_MODE)
You can change the number of event processing thread in the master process.
To make full use of cpu, the default number of reactor_num is the number of core in cpu.
In general, the number of the reactor thread is between one and four times of cpu cores.
Set the buffer size of socket.
This configuration is to set the max memory size of connection.
<?php
$server->set([
'socket_buffer_size' => 128 * 1024 *1024,
])
It must add
--enable-opensslto the support for ssl when you compile the swoole
To enable ssl, it should set the file path of the cert file and the key file.
<?php
$server = new swoole_server("0.0.0.0", 9501, SWOOLE_PROCESS, SWOOLE_SOCK_TCP | SWOOLE_SSL);
$server->set(array(
'ssl_cert_file' => __DIR__ . '/config/ssl.cert',
'ssl_key_file' => __DIR__ . '/config/ssl.key',
));
Convert PEM to DER
openssl x509 -in cert.crt -outform der -out cert.der
Convert DER to PEM
openssl x509 -in cert.crt -inform der -outform pem -out cert.pem
Set the ssl_ciphers to change the default encryption algorithm of openssl. The default encryption algorithm of openssl is EECDH+AESGCM:EDH+AESGCM:AES256+EECDH:AES256+EDH
<?php
$server->on(array(
'ssl_ciphers' => 'ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP', // the swoole use the default algorithm when the `ssl_ciphers` is empty
));
It must add
--enable-opensslto the support for ssl when you compile the swoole
To enable ssl, it should set the file path of the cert file and the key file.
<?php
$server = new swoole_server("0.0.0.0", 9501, SWOOLE_PROCESS, SWOOLE_SOCK_TCP | SWOOLE_SSL);
$server->set(array(
'ssl_cert_file' => __DIR__ . '/config/ssl.cert',
'ssl_key_file' => __DIR__ . '/config/ssl.key',
));
Convert PEM to DER
openssl x509 -in cert.crt -outform der -out cert.der
Convert DER to PEM
openssl x509 -in cert.crt -inform der -outform pem -out cert.pem
Set the algorithm of ssl. The algorithm of client and server must be same otherwise the handshake of websocket will fail.
The default algorithm is SWOOLE_SSLv23_METHOD
<?php
$server->set(array(
'ssl_method' => SWOOLE_SSLv3_CLIENT_METHOD, // this configuration is available for the swoole whose version is higher than 1.7.20
));
Set the communication mode between the task worker process and worker process.
1, default mode, use unix socket to communicate
2, use the message queue to communicate
3, use the message queue to communicate and set the mode to competition
the difference between mode
2and3: mode2supports the feature of sending task to a specified task worker process by$serv->task($data, $task_worker_id)while the mode3don't support to specify task worker process.
The message queue uses the memory queue provided by os to store the data.
If the configuration mssage_queue_key hasn't been seted, the message queue would use the private queue and this private queue would been deleted after the close of swoole server.
If the configuration mssage_queue_key has been seted, the data of message queue would not be deleted and the swoole server could get the data after restart.
Use ipcrm -q message_queue_id to delete the data of message queue
the max number of task the task worker process could handle.
After handling the number of task_max_request tasks, the task worker process will exit and release all the memory amd resouce occupied by this process. And then, the manager will respawn a new task worker process.
The dafault value of task_max_request is 0 which means there is no limit of the max task request.
Set the path of temporary task data.
If the data sended by task exceeds 8192 bytes, the swoole will use the temporary file to store the data.
The default of task_tmpdir is /tmp.
the number of task worker process.
To enable this parameter, it needs to register the callback function of task event and finish event.
The task worker process is synchronous and blocking.
According to the speed of sending task and handling task, set a reasonable value of task_worker_num.
This configuration is to defer the tcp connection to trigger accept.
Set the user of worker and task worker process.
<?php
$serv->set(array('user' => 'apache'));
The number of the worker process
If the code of logic is asynchronous and non-blocking, set the worker_num to the value from one times to four times of cpu cores.
If the code of logic is synchronous and blocking, set the worker_num according to the consuming time of request and load of os.