Что означают сигнатуры функций на php.net?

Итак, по частям:

string system ( string $command [ , int & $return_var ]  )
1      2      3 4      5        6 7 8   9 10          11 12

Для того, чтобы:

1. строка - возвращаемый тип
2. system - имя команды
3. (- начало аргументов функции
4. строка - тип первого аргумента
5. $ command - имя первого аргумента (это просто подсказка, не влияет на то, как вы вызываете функцию)
6. [- начало необязательных аргументов
7. , - это показывает, что вы разделяете аргументы запятой
8. int - тип первого необязательного аргумента
9. & - указывает, что первый необязательный аргумент будет передан по ссылке (функция может изменять переданную переменную **)
10. $ return_var - имя первого необязательного аргумента
11. ] - конец необязательных аргументов
12. ) - конец аргументов функции

Это намекает на то, что может потребоваться для вызова функции. Итак, синтаксически допустимо следующее:

$return_type = 1;
system("String!", $return_type);
//$return_type could have changed

system("String!", $return_type);

system("String!");

Но это не так:

system();

system($var_that_wont_cast_to_string);

** Документы PHP передаются по ссылке: http://php.net/manual/ ru / language.references.pass.php