Skip to content

Commit

Permalink
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Remove FIXME as PHP implemented the return type
Browse files Browse the repository at this point in the history
The documentation on this is not very clear. You can encounter the `False` by using unset($argv) which would be a misconfiguration so the error message is now also improved.

A better explanation can be found here: https://bugs.php.net/bug.php?id=81352

Which has those comments;
```
 [2021-08-12 15:19 UTC] [email protected]
Prior to PHP 8.0.0, FALSE was returned if the function was called
with unexpected parameters or parameter types.  Most other
functions returned NULL in that case.  Anyhow, there is no need to
document that, since this is actually undefined behavior[1].

For all relevant PHP versions, FALSE will also be returned, if
neither $_SERVER nor $argv exists or are not arrays.

[1] <https://www.php.net/manual/en/functions.internal.php>

 [2022-11-26 06:42 UTC] schamberumarcelo at gmail dot com
getopt() will return an empty array if there is no error in splitting strings to args variable. GetOptions() will return a true value if the command line could be processed successfully. Otherwise, it will write error messages using die() and warn(). (https://www.imyccpay.com)github.com
```
 given that we run PHP>8.0 and the explanation that parsing will stop for the first non-option I think we'll never encounter the false in practice. To be save we now check the shortoptions string for the right format.

To be sure an internal function is now added which does some extra parsing to find unknown arguments, alternative would be to use: (https://www.php.net/manual/en/function.getopt.php#83414).
Michael Vasseur committed Nov 22, 2024
1 parent 1885c3f commit 348ea2d
Showing 1 changed file with 27 additions and 6 deletions.
33 changes: 27 additions & 6 deletions judge/judgedaemon.main.php
Original file line number Diff line number Diff line change
@@ -16,6 +16,32 @@
$endpoints = [];
$domjudge_config = [];

function dj_getopt(string $short_options, array $long_options = []): array
{
global $argv;
define('GETOPT_REGEX', "/^([a-zA-Z0-9]:{0,2})*$/");
if (preg_match(GETOPT_REGEX, $short_options) !== 1) {
echo "Error: short options format specified is invalid.\n";
usage();
}
$options = getopt($short_options, $long_options);
if ($options===false || !is_array($argv)) {
echo "Error: parsing options failed.\nPlease check: `register_argc_arg` in php.ini.\n";
usage();
}
$unknown = false;
foreach (array_slice($argv, 1) as $arg) {
if (str_starts_with($arg, '-') && !array_key_exists(ltrim($arg, '-'), $options)) {
echo "Error: Unknown option: $arg\n";
$unknown = true;
}
}
if ($unknown) {
usage();
}
return $options;
}

function judging_directory(string $workdirpath, array $judgeTask) : string
{
if (filter_var($judgeTask['submitid'], FILTER_VALIDATE_INT) === false ||
@@ -487,12 +513,7 @@ function fetch_executable_internal(
return [$execrunpath, null, null];
}

$options = getopt("dv:n:hVe:j:t:", ["diskspace-error"]);
// FIXME: getopt doesn't return FALSE on parse failure as documented!
if ($options===false) {
echo "Error: parsing options failed.\n";
usage();
}
$options = dj_getopt("dv:n:hVe:j:t:", ["diskspace-error"]);
if (isset($options['v'])) {
$options['verbose'] = $options['v'];
}

0 comments on commit 348ea2d

Please sign in to comment.