# Server
### 构建Server对象
~~~
$serv = new swoole_server("127.0.0.1", 9501, SWOOLE_BASE, SWOOLE_SOCK_TCP);
~~~
> swoole_server只能用于php-cli环境
### 设置运行时参数
~~~
$serv->set(array('worker_num' => 4, 'daemonize' => true));
~~~
### 注册事件回调函数
~~~
$serv->on('Connect', 'my_onConnect');
$serv->on('Receive', 'my_onReceive');
$serv->on('Close', 'my_onClose');
~~~
### 属性列表
~~~
$serv->manager_pid; //管理进程的PID,通过向管理进程发送SIGUSR1信号可实现柔性重启
$serv->master_pid; //主进程的PID,通过向主进程发送SIGTERM信号可安全关闭服务器
~~~
### 运行流程图
![Swoole扩展架构图](https://box.kancloud.cn/2016-08-30_57c5268f86e00.jpg)
### 进程/线程结构图
![Swoole进程/线程结构图](https://box.kancloud.cn/2016-08-30_57c5268fb3216.jpg)
### 注意事项
- 不要在代码中执行sleep,这样会导致整个进程阻塞
- exit/die是危险的,会导致worker进程退出
- 可通过register_shutdown_function来捕获致命错误,在进程异常退出时做一些请求工作,具体如下
~~~
register_shutdown_function('handleFatal');
function handleFatal()
{
$error = error_get_last();
if (isset($error['type']))
{
switch ($error['type'])
{
case E_ERROR :
case E_PARSE :
case E_DEPRECATED:
case E_CORE_ERROR :
case E_COMPILE_ERROR :
$message = $error['message'];
$file = $error['file'];
$line = $error['line'];
$log = "$message ($file:$line)\nStack trace:\n";
$trace = debug_backtrace();
foreach ($trace as $i => $t)
{
if (!isset($t['file']))
{
$t['file'] = 'unknown';
}
if (!isset($t['line']))
{
$t['line'] = 0;
}
if (!isset($t['function']))
{
$t['function'] = 'unknown';
}
$log .= "#$i {$t['file']}({$t['line']}): ";
if (isset($t['object']) && is_object($t['object']))
{
$log .= get_class($t['object']) . '->';
}
$log .= "{$t['function']}()\n";
}
if (isset($_SERVER['REQUEST_URI']))
{
$log .= '[QUERY] ' . $_SERVER['REQUEST_URI'];
}
error_log($log);
$serv->send($this->currentFd, $log);
}
}
}
~~~
- Swoole
- 入门指引
- 环境依赖
- 编译安装
- 编译参数
- 常见错误
- 运行程序
- 创建TCP服务器
- 创建UDP服务器
- 创建Web服务器
- 创建WebSocket服务器
- 设置定时器
- 执行异步任务
- 创建同步TCP客户端
- 创建异步TCP客户端
- 网络通信协议设计
- 异步编程入门
- sleep/usleep的影响
- exit/die函数的影响
- while循环的影响
- 版本更新记录
- 1.8.3
- 1.8.4
- 1.8.5(开发中)
- 新特性使用
- 1.7.16 使用迭代器遍历Server所有连接
- 1.7.5 在Server中使用swoole_table
- 1.7.5 swoole_client支持sendfile接口
- 1.7.4 SSL隧道加密TCP-Server
- 1.7.4 task进程中使用毫秒定时器
- 1.7.3 固定包头+包体协议自动分包
- 1.7.3 onTask直接return取代finish函数
- 1.7.2 swoole_process多进程模块的使用
- 1.7.2 task进程使用消息队列
- 常见问题
- 升级swoole版本的常见问题
- 生成可分发的二进制swoole版本
- Connection refused是怎么回事
- Resource temporarily unavailable [11]
- Cannot assign requested address [99]
- pcre.h: No such file or directory
- 在phpinfo中有在php-m中没有
- swoole与node.js相比有哪些优势
- swoole与golang相比有哪些优势
- my_global.h: No such file or directory
- undefined symbol: __sync_bool_compare_and_swap_4
- 学习Swoole需要掌握哪些基础知识
- 开发者列表
- php.ini选项
- 项目路线图
- 提交错误报告
- 内核参数调整
- 周边相关项目
- Server
- 函数列表
- swoole_server::__construct
- swoole_server::set
- swoole_server::on
- swoole_server::addListener
- swoole_server::addProcess
- swoole_server::listen
- swoole_server::start
- swoole_server::reload
- swoole_server::shutdown
- swoole_server::tick
- swoole_server::after
- swoole_server::defer
- swoole_server::clearTimer
- swoole_server::close
- swoole_server::send
- swoole_server::sendfile
- swoole_server::sendto
- swoole_server::sendwait
- swoole_server::sendMessage
- swoole_server::exist
- swoole_server::connection_info
- swoole_server::connection_list
- swoole_server::bind
- swoole_server::stats
- swoole_server::task
- swoole_server::taskwait
- swoole_server::finish
- swoole_server::heartbeat
- swoole_get_mysqli_sock
- swoole_set_process_name
- swoole_version
- swoole_strerror
- swoole_errno
- swoole_get_local_ip
- 属性列表
- swoole_server::$setting
- swoole_server::$master_pid
- swoole_server::$manager_pid
- swoole_server::$worker_id
- swoole_server::$worker_pid
- swoole_server::$taskworker
- swoole_server::$connections
- 配置选项
- reactor_num
- worker_num
- max_request
- max_conn (max_connection)
- task_worker_num
- task_ipc_mode
- task_max_request
- task_tmpdir
- task_worker_max
- dispatch_mode
- message_queue_key
- daemonize
- backlog
- log_file
- log_level
- heartbeat_check_interval
- heartbeat_idle_time
- open_eof_check
- open_eof_split
- package_eof
- open_length_check
- package_length_type
- package_max_length
- open_cpu_affinity
- cpu_affinity_ignore
- open_tcp_nodelay
- tcp_defer_accept
- ssl_cert_file
- ssl_method
- user
- group
- chroot
- pipe_buffer_size
- buffer_output_size
- enable_unsafe_event
- discard_timeout_request
- enable_reuse_port
- 监听端口
- 可选参数
- 可选回调
- 事件回调函数
- onStart
- onShutdown
- onWorkerStart
- onWorkerStop
- onTimer
- onConnect
- onReceive
- onPacket
- onClose
- onTask
- onFinish
- onPipeMessage
- onWorkerError
- onManagerStart
- onManagerStop
- 高级特性
- 改变Worker进程的用户/组
- 回调函数中的from_id和fd
- Buffer和EOF_Check的使用
- Worker与Reactor通信模式
- TCP-Keepalive死连接检测
- TCP服务器心跳维持方案
- 多端口监听的使用
- 捕获Server运行期致命错误
- swoole_server的3种运行模式介绍
- swoole_server中对象的4层生命周期
- 在worker进程内监听一个Server端口
- 常见问题
- 为什么不要send完后立即close
- 如何在回调函数中访问外部的变量
- swoole_server中内存管理机制
- 是否可以共用1个redis或mysql连接
- 关于onConnect/onReceive/onClose顺序
- 4种PHP回调函数风格
- 不同的Server程序实例间如何通信
- 压力测试
- Nginx/Golang/Swoole/Node.js的性能对比
- 并发10万TCP连接的测试
- 预定义常量
- php.ini选项
- Client
- 方法列表
- swoole_client::__construct
- swoole_client::set
- swoole_client::on
- swoole_client::connect
- swoole_client::isConnected
- swoole_client::getsockname
- swoole_client::getpeername
- swoole_client::send
- swoole_client::sendto
- swoole_client::sendfile
- swoole_client::recv
- swoole_client::close
- swoole_client::sleep
- swoole_client::wakeup
- 回调函数
- onConnect
- onError
- onReceive
- onClose
- 属性列表
- swoole_client::$errCode
- swoole_client::$sock
- swoole_client::$reuse
- 并行
- swoole_client_select
- TCP客户端异步连接
- SWOOLE_KEEP建立TCP长连接
- 常量
- Process
- 方法列表
- swoole_process::__construct
- swoole_process::start
- swoole_process::name
- swoole_process::exec
- swoole_process::write
- swoole_process::read
- swoole_process::useQueue
- swoole_process::push
- swoole_process::pop
- swoole_process::close
- swoole_process::exit
- swoole_process::kill
- swoole_process::wait
- swoole_process::daemon
- swoole_process::signal
- swoole_process::setaffinity
- AsyncIO
- 异步文件系统IO
- swoole_async_readfile
- swoole_async_writefile
- swoole_async_read
- swoole_async_write
- swoole_async_dns_lookup
- EventLoop
- swoole_event_add
- swoole_event_set
- swoole_event_del
- swoole_event_exit
- swoole_event_wait
- swoole_event_write
- 异步毫秒定时器
- swoole_timer_add
- swoole_timer_del
- swoole_timer_tick
- swoole_timer_after
- swoole_timer_clear
- 异步MySQL客户端
- swoole_get_mysqli_sock
- swoole_mysql_query
- 异步Redis客户端
- swoole_redis-
- swoole_redis-
- swoole_redis-
- swoole_redis-
- 异步Http/WebSocket客户端
- swoole_http_client-
- swoole_http_client-
- swoole_http_client-
- swoole_http_client-
- swoole_http_client-
- swoole_http_client-
- swoole_http_client-
- Memory
- Lock
- swoole_lock::__construct
- swoole_lock::lock
- swoole_lock::trylock
- swoole_lock::unlock
- swoole_lock::lock_read
- swoole_lock::trylock_read
- Buffer
- swoole_buffer::__construct
- swoole_buffer::append
- swoole_buffer::substr
- swoole_buffer::clear
- swoole_buffer::expand
- swoole_buffer::write
- swoole_buffer::read
- Table
- swoole_table::__construct
- swoole_table::column
- swoole_table::create
- swoole_table::set
- swoole_table::incr
- swoole_table::decr
- swoole_table::get
- swoole_table::exist
- swoole_table::del
- swoole_table::lock
- swoole_table::unlock
- 常量列表
- Atomic
- swoole_atomic::__construct
- swoole_atomic::add
- swoole_atomic::sub
- swoole_atomic::get
- swoole_atomic::set
- swoole_atomic::cmpset
- HttpServer
- swoole_http_server
- swoole_http_server::on
- swoole_http_server::start
- swoole_http_server::setGlobal
- swoole_http_request
- swoole_http_request::$header
- swoole_http_request::$server
- swoole_http_request::$get
- swoole_http_request::$post
- swoole_http_request::$cookie
- swoole_http_request::$files
- swoole_http_request::rawContent
- swoole_http_response
- swoole_http_response::header
- swoole_http_response::cookie
- swoole_http_response::status
- swoole_http_response::gzip
- swoole_http_response::write
- swoole_http_response::sendfile
- swoole_http_response::end
- 常见问题
- CURL发送POST请求服务器端超时
- 使用Chrome访问服务器会产生2次请求
- GET/POST请求的最大尺寸
- WebSocket
- 回调函数
- onHandShake
- onOpen
- onMessage
- 函数列表
- swoole_websocket_server::push
- 常见问题
- 如何判断连接是否为WebSocket客户端
- 预定义常量
- 高级
- 守护进程程序常用数据结构
- 队列(Queue)
- Swoole的实现
- Reactor线程
- Manager进程
- Worker进程
- Reactor、Worker、Task的关系
- Task/Finish特性的用途
- C/C++开发者如何使用Swoole
- 在php-fpm或apache中使用swoole在php-fpm或apache中使用swoole
- Swoole异步与同步的选择
- TCP/UDP压测工具
- swoole服务器如何做到无人值守100
- MySQL的连接池、异步、断线重连
- PHP中那些函数是同步阻塞的
- 使用tcmalloc提升swoole内存分配性能
- 使用tcmalloc提升swoole内存分配性能
- 其他
- Swoole社区
- 加入Swoole开发组
- 附录:Linux信号列表
- 附录:Linux错误信息(errno)列表
- 附录:TCP连接的状态
- 附录:tcpdump抓包工具的使用
- 附录:strace工具的使用
- 附录:gdb工具的使用
- 附录:编译PHP扩展的相关工具
- 备用:已移除的历史特性
- onMasterConnect
- onMasterClose
- 历史:版本更新记录
- v1.8.2
- v1.8.1
- v1.8.0
- v1.7.22
- v1.7.21
- v1.7.20
- v1.7.19
- v1.7.18
- v1.7.17
- v1.7.16
- v1.7.15
- v1.7.14
- v1.7.13
- v1.7.12
- v1.7.11
- v1.7.10
- v1.7.9
- v1.7.8
- v1.7.7
- v1.7.6
- v1.7.5
- v1.7
- v1.6
- v1.5
- Swoole-framework
- 开发指南
- 数据库Model类
- model::get
- model::set
- model::del
- model::put
- model::gets
- model::sets
- model::dels
- model::all
- model::count
- model::exists
- model($model_name)
- table($table_name)
- Socket网络开发
- TCP服务器
- Web服务器
- WebSocket
- Nginx+Swoole服务器配置
- Apache+Swoole服务器配置
- 安装Swoole框架和扩展
- 数据库ORM接口
- 控制器Controller
- 命名空间
- 文件上传组件
- Redis
- Database
- Swoole\Database::insert
- 框架规范
- 目录规范
- 自定义路由
- URL映射规则
- 示例程序
- 服务器端程序(Server)
- http_server
- app_server
- soa_server
- websocket_server
- comet_server
- 配置文件