Description:
------------
Getopt has 2 deficiencies that make it hard to use at the command line:

1) If an illegal option is used on the command line, this is not reported to the PHP script. This means that an error/... message cannot be generated.

2) Most programs will expect arguments after the options. getopt() does not let the application know how many elements in argv have been used by options. The Unix getopt(3) will put this number in the global variable 'optind'.

Both of these could be remedied by there being 2 extra elements where the keys are:
'optind' -- number of elements used from argv;
'badopts' -- an array that contains the options that were not recognised.
Since this might confuse existing programs I suggest that these 2 extra elements only by created if the getopt $options argument string starts with a ':'.

Test script:
---------------
<?php

$optstring = "ab:";

echo "optstring='$optstring'\n";
$args = getopt($optstring);
var_dump($args);
?>

Run it:

php test.php -a -q -b ff -bxx ffff

Note that '-q' is not reported as a bad argument. There is no indication that '-bxx' is the last argument.