提交错误报告

当使用swoole发生段错误时,请及时向开发组报告。可以使用gdb工具来得到一份bt信息。使用gdb跟踪需要在编译swoole时增加—enable-debug参数。

如果不方便gdb,也可以提供一份可稳定复现的demo程序

打开core dump

  1. ulimit -c unlimited

使用gdb来查看core dump信息。core文件一般在当前目录,如果操作系统做了处理,将core dump文件放置到其他目录,请替换为相应的路径

  1. gdb php core
  2. gdb php /tmp/core.4596

在gdb下输入bt查看调用栈信息

  1. (gdb)bt
  2. Program terminated with signal 11, Segmentation fault.
  3. #0 0x00007f1cdbe205e0 in swServer_onTimer (reactor=<value optimized out>, event=...)
  4. at /usr/local/php/swoole-swoole-1.5.9b/src/network/Server.c:92
  5. 92 serv->onTimer(serv, timer_node->interval);
  6. Missing separate debuginfos, use: debuginfo-install php-cli-5.3.3-22.el6.x86_64

在gdb中使用f指令查看代码段

  1. (gdb)f 1
  2. (gdb)f 0

如果没有函数调用栈信息,可能是编译去除了debug信息。请手工修改swoole源码目录下的Makefile文件,修改CFLAGS为

  1. CFLAGS = -Wall -pthread -g -O0

内存检测

除了使用gdb分析之外可以使用valgrind工具检测程序是否正常运行。

  1. USE_ZEND_ALLOC=0 valgrind php your_file.php
  • 程序逻辑覆盖后执行ctrl+c中断,将屏幕打印的信息复制到文件中
  1. 注意:有些情况下在虚拟机下共享目录core文件无法生成,会生成一个0字节的文件,请将core文件生成目录改到/var/log/core下。

提交问题

请将上面的得到的信息,连同机器信息,包括php -v gcc -v uname -a 提交到 Github Issues页面 或者发送邮件到 team@swoole.com

若确定是Swoole底层的问题,开发组会快速解决。

反馈建议

为了减少Swoole内核开发者与反馈者之间的沟通成本,请认真阅读以下内容,在GitHub平台尽可能地按照Issue模板提交问题。

  • 请提供发生问题时使用的phpswoole、操作系统、gccopenssl(可选)版本信息
  • 请描述具体是什么情况下发生,尽可能地给出可稳定重现的代码测试过程
  • 请使用valgrindgdbstrace等工具进行初步地问题跟踪,并贴出相关信息和线索
  • 请认真查看php错误日志、swoolelog_file、操作系统的syslog等日志信息,找到可能与该问题关联的信息和线索

获取版本信息

php

  1. php -v

swoole

  1. php --ri swoole

操作系统类型

LinuxMacOSFreeBSDCygWin树莓派

内核版本

  1. uname -a

gcc

  1. gcc -v

openssl

  1. openssl version