Как работает функция readline в PHP при взаимодействии с командной строкой?

Функция readline в PHP при взаимодействии с командной строкой работает так: она читает одну строку, которую ввёл пользователь. 1 При этом функция удаляет из конца строки, которую вернула командная оболочка, символ новой строки. 1 Если не осталось данных для чтения, функция возвращает false. 1

У функции есть необязательный параметр prompt, который содержит строку для показа пользователю в качестве подсказки. 2