# onStart [TOC] 启动后在**主进程（master）**的主线程回调此函数，函数原型 ~~~ function onStart(Server $server); ~~~ 在此事件之前`Server`已进行了如下操作 * 已创建了`manager`进程 * 已创建了`worker`子进程 * 已监听所有`TCP/UDP/UnixSocket`端口，但未开始`Accept`连接和请求 * 已监听了定时器 接下来要执行 * 主`Reactor`开始接收事件，客户端可以`connect`到`Server` **onStart回调中，仅允许echo、打印Log、修改进程名称。不得执行其他操作。onWorkerStart和onStart回调是在不同进程中并行执行的，不存在先后顺序。** 可以在`onStart`回调中，将`$serv->master_pid`和`$serv->manager_pid`的值保存到一个文件中。这样可以编写脚本，向这两个PID发送信号来实现关闭和重启的操作。 onStart事件在Master进程的主线程中被调用。 > 在`onStart`中创建的**全局资源对象**不能在`Worker`进程中被使用，因为发生`onStart`调用时，worker进程已经创建好了 > 新创建的对象在主进程内，`Worker`进程无法访问到此内存区域 > 因此全局对象创建的代码需要放置在`Server::start`之前 ## 安全提示 在`onStart`回调中可以使用异步和协程的`API`，但需要注意这可能会与`dispatch_func`和`package_length_func`存在冲突。请勿同时使用。 `onStart`回调在`return`之前服务器程序不会接受任何客户端连接，因此可以安全地使用`CURL`等`PHP`提供的同步`IO`函数。 ## BASE 模式 `BASE`模式下没有`master`进程，因此不存在`onStart`事件。请不要在`BASE`模式中使用使用`onStart`回调函数。