必须替换为协程安全函数：sleep()、usleep()、file_get_contents()（未Hook时）、curl_exec()、stream_socket_client()等阻塞函数会挂起协程、阻塞EventLoop；session_start()、setcookie()、error_log()、ini_set()易污染全局状态或引发泄漏；pcntl_fork()、socket_create()、gethostbyname()、mysqli_connect()（未Hook）在Swoole 5.0+中已不兼容或禁用。
在 Swoole 常驻进程模型下，直接调用某些 PHP 原生函数会导致不可预测的副作用——不是报错，而是悄悄破坏协程上下文、阻塞 EventLoop 或引发内存泄漏。这些函数本身没被 Swoole “禁用”，但它们与协程运行时天然冲突。
哪些函数会破坏协程调度
这类函数内部调用的是阻塞式系统调用（如 sleep、file_get_contents），一旦执行，整个协程线程会被挂起，其他协程无法调度，EventLoop 停摆。
-
sleep()：必须替换为co::sleep()，否则卡死整个 Worker -
usleep()、time_nanosleep()：同理，全部失效且无警告 -
file_get_contents()（未启用钩子时）：默认走阻塞 read，应改用Co\Http\Client或启用SWOOLE_HOOK_FILE -
curl_exec()：原生 cURL 阻塞，需配合SWOOLE_HOOK_CURL或改用协程客户端 -
stream_socket_client()：底层阻塞连接，协程中必须用Co\Socket或Co\Http\Client
哪些函数会污染全局状态或引发内存泄漏
Swoole 进程常驻，$_SESSION、$_COOKIE、static 变量等不再随请求销毁，而部分函数会隐式修改它们，导致跨请求污染。
-
session_start()：PHP 默认 session handler 是阻塞文件锁，且会污染全局$_SESSION；Swoole 中应使用 Redis/DB 自定义 SessionManager + 协程安全驱动 -
setcookie()：仅设置响应头，但若在协程中多次调用（如重定向后又 push），可能覆盖或错乱；建议统一由$response->cookie()管理 -
error_log()：在高并发下写文件易触发 IO 阻塞；更危险的是，某些旧版可被用于绕过disable_functions执行命令（如写入 Webshell） -
ini_set()：修改运行时配置会影响整个进程，比如ini_set('memory_limit', '-1')会让所有协程共享失控内存
哪些函数在 Swoole 5.0+ 中已明确不兼容
Swoole 5.0 彻底重构协程调度器和 Hook 机制，部分函数即使加了钩子也无法安全使用，官方已标记为“不推荐”或移除支持。
立即学习“PHP免费学习笔记（深入）”；
-
pcntl_fork()：Swoole 5.0 禁止在协程中调用，会直接 fatal error；多进程应交由Co\Process\Manager统一管理 -
socket_create()：底层 socket 资源无法被协程调度器接管；必须用Co\Socket或Co\Coroutine\Socket -
gethostbyname()：DNS 查询阻塞，应改用Co\DNS\Resolver或Co\Http\Client内置解析 -
mysqli_connect()（未启用SWOOLE_HOOK_MYSQLI）：阻塞连接，且连接资源不会自动回收；推荐搭配连接池使用Swoole\Coroutine\MySQL
最常被忽略的一点是：这些函数在开发环境可能“看起来正常”，因为单请求、低并发下阻塞不明显；但上线后 QPS 上升，sleep(1) 就能让整个 Worker 吞吐归零。判断依据不是“有没有报错”，而是看 swoole_get_local_cid() 是否变化、co::stats() 中协程等待数是否持续上涨。
