pcntl_alarm函数在PHP中用于设置一个闹钟，该闹钟将在指定的秒数后发送一个SIGALRM信号到进程。

语法:
“`php
int pcntl_alarm ( int $seconds )
“`
这个函数只接受一个参数：
– seconds: 非负整数，定义了要等待的秒数。如果设置为0，则将关闭任何已存在的闹钟。

返回值:
此函数返回上一次设置的闹钟的时间，单位是秒。

注意事项:
– 此函数不适用于Windows平台。
– 如果你的代码需要在接收到 SIGALRM 信号时执行特定操作，需要使用 pcntl_signal() 函数注册一个处理器。
– 这个函数仅在CLI SAPI（命令行接口）下可用。

示例:
“`php
declare(ticks = 1);

// signal handler function
function sig_handler($signo)
{
switch ($signo) {
case SIGALRM:
// handle shutdown tasks
echo “Received SIGALRM, processing signal\n”;
break;
default:
// handle all other signals
}
}

echo “Installing signal handler…\n”;

// setup signal handler
pcntl_signal(SIGALRM, “sig_handler”);

echo “Generating alarm in 2 seconds\n”;

// generate an alarm in 2 seconds
pcntl_alarm(2);

while (1) {
// sleep for one second
sleep(1);
echo “Waiting…\n”;
}
“`
在这个例子中，我们首先声明一个用来处理信号的函数。然后，我们使用pcntl_signal()函数来安装这个函数作为SIGALRM信号的处理器。接着，我们使用pcntl_alarm()函数产生一个在两秒后会响应的闹钟。最后，我们让脚本进入一个无限循环，等待信号的到来。