1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
|
<?php
namespace Safe;
use Safe\Exceptions\PcntlException;
/**
* Executes the program with the given arguments.
*
* @param string $path path must be the path to a binary executable or a
* script with a valid path pointing to an executable in the shebang (
* #!/usr/local/bin/perl for example) as the first line. See your system's
* man execve(2) page for additional information.
* @param array $args args is an array of argument strings passed to the
* program.
* @param array $envs envs is an array of strings which are passed as
* environment to the program. The array is in the format of name => value,
* the key being the name of the environmental variable and the value being
* the value of that variable.
* @throws PcntlException
*
*/
function pcntl_exec(string $path, array $args = null, array $envs = null): void
{
error_clear_last();
if ($envs !== null) {
$result = \pcntl_exec($path, $args, $envs);
} elseif ($args !== null) {
$result = \pcntl_exec($path, $args);
} else {
$result = \pcntl_exec($path);
}
if ($result === false) {
throw PcntlException::createFromPhpError();
}
}
/**
* pcntl_getpriority gets the priority of
* pid. Because priority levels can differ between
* system types and kernel versions, please see your system's getpriority(2)
* man page for specific details.
*
* @param int $pid If not specified, the pid of the current process is used.
* @param int $process_identifier One of PRIO_PGRP, PRIO_USER
* or PRIO_PROCESS.
* @return int pcntl_getpriority returns the priority of the process. A lower numerical value causes more favorable
* scheduling.
* @throws PcntlException
*
*/
function pcntl_getpriority(int $pid = null, int $process_identifier = PRIO_PROCESS): int
{
error_clear_last();
if ($process_identifier !== PRIO_PROCESS) {
$result = \pcntl_getpriority($pid, $process_identifier);
} elseif ($pid !== null) {
$result = \pcntl_getpriority($pid);
} else {
$result = \pcntl_getpriority();
}
if ($result === false) {
throw PcntlException::createFromPhpError();
}
return $result;
}
/**
* pcntl_setpriority sets the priority of
* pid.
*
* @param int $priority priority is generally a value in the range
* -20 to 20. The default priority
* is 0 while a lower numerical value causes more
* favorable scheduling. Because priority levels can differ between
* system types and kernel versions, please see your system's setpriority(2)
* man page for specific details.
* @param int $pid If not specified, the pid of the current process is used.
* @param int $process_identifier One of PRIO_PGRP, PRIO_USER
* or PRIO_PROCESS.
* @throws PcntlException
*
*/
function pcntl_setpriority(int $priority, int $pid = null, int $process_identifier = PRIO_PROCESS): void
{
error_clear_last();
if ($process_identifier !== PRIO_PROCESS) {
$result = \pcntl_setpriority($priority, $pid, $process_identifier);
} elseif ($pid !== null) {
$result = \pcntl_setpriority($priority, $pid);
} else {
$result = \pcntl_setpriority($priority);
}
if ($result === false) {
throw PcntlException::createFromPhpError();
}
}
/**
* The pcntl_signal_dispatch function calls the signal
* handlers installed by pcntl_signal for each pending
* signal.
*
* @throws PcntlException
*
*/
function pcntl_signal_dispatch(): void
{
error_clear_last();
$result = \pcntl_signal_dispatch();
if ($result === false) {
throw PcntlException::createFromPhpError();
}
}
/**
* The pcntl_sigprocmask function adds, removes or sets blocked
* signals, depending on the how parameter.
*
* @param int $how Sets the behavior of pcntl_sigprocmask. Possible
* values:
*
* SIG_BLOCK: Add the signals to the
* currently blocked signals.
* SIG_UNBLOCK: Remove the signals from the
* currently blocked signals.
* SIG_SETMASK: Replace the currently
* blocked signals by the given list of signals.
*
* @param array $set List of signals.
* @param array|null $oldset The oldset parameter is set to an array
* containing the list of the previously blocked signals.
* @throws PcntlException
*
*/
function pcntl_sigprocmask(int $how, array $set, ?array &$oldset = null): void
{
error_clear_last();
$result = \pcntl_sigprocmask($how, $set, $oldset);
if ($result === false) {
throw PcntlException::createFromPhpError();
}
}
/**
*
*
* @param int $errno
* @return string Returns error description on success.
* @throws PcntlException
*
*/
function pcntl_strerror(int $errno): string
{
error_clear_last();
$result = \pcntl_strerror($errno);
if ($result === false) {
throw PcntlException::createFromPhpError();
}
return $result;
}
|
