FilePicker

Browse the filesystem for a single path. It collects the chosen path (a string).

$p->filePicker('list', 'Price list')
  ->startIn(getcwd())    // Directory to open in (and the floor for ←).
  ->filesOnly()          // Only files are selectable; directories stay navigable.
  ->extensions(['csv'])  // Limit selectable files to these extensions.
  ->maxSize(5_000_000)   // Reject a selected file larger than this many bytes.
  ->showHidden();        // Show hidden (dot) entries when the browser opens.

Runnable scripts: playground/02-widgets-filepicker.php and filepicker-multiple.php.

Options

Name	Description	Required	Default
`startIn()`	Directory the browser opens in, and the floor it cannot ascend above.	No	Current directory
`filesOnly()`	Only files are selectable; directories stay navigable.	No	Files and directories
`directoriesOnly()`	Only directories are selectable.	No	Files and directories
`extensions()`	Restrict selectable files to these extensions (dot-less, case-insensitive).	No	All
`maxSize()`	Reject any selected file larger than this many bytes.	No	No limit
`showHidden()`	Show hidden (dot) entries when the browser opens.	No	Off
`pageSize()`	Entries shown before the list pages around the cursor.	No	`10`

filesOnly() and directoriesOnly() are mutually exclusive - the last one set wins.

Keyboard

Key	Action
`↑` / `↓`	Move the highlight
`→`	Descend into the highlighted directory
`←`	Ascend to the parent (never above the start directory)
printable keys	Filter the current directory
`Tab`	Toggle hidden entries
`Backspace`	Delete a filter character, or ascend when the filter is empty
`Enter`	Select the highlighted entry if selectable, otherwise descend into the directory
`Esc`	Cancel

Display modes

In all four display modes - Unicode or ASCII, color on or off:

	ANSI	No ANSI
Unicode
ASCII

Type and size constraints

Constrain what counts as a valid pick with ->filesOnly() / ->directoriesOnly(), ->extensions() and ->maxSize(). The active limits show as a hint below the browser, a pick that breaks one is rejected inline when you accept, and the same limits are enforced in headless collection.

$p->filePicker('list', 'Price list')
  ->filesOnly()          // A directory (or a missing path) is not a valid pick.
  ->extensions(['csv'])  // Only .csv files may be chosen.
  ->maxSize(5_000_000);  // Reject a file larger than 5 MB.

A missing path, a directory where a file is required (or the reverse), a disallowed extension, or an oversized file each fail with a message naming the unmet limit.

Multiple selection

Add ->multiple() to accumulate several paths (a list<string>) instead of one: Space toggles the highlighted entry, selections stick as you browse between directories, and Enter accepts them all.

$p->filePicker('lists', 'Price lists')
  ->multiple()
  ->startIn(getcwd())
  ->extensions(['csv']);

	ANSI	No ANSI
Unicode
ASCII

Selection limits

Bound how many paths a multiple file picker collects with ->minSelections() and ->maxSelections(). The active limit shows as a hint below the browser, an out-of-range selection is rejected inline when you accept, and the same bounds are enforced in headless collection.

$p->filePicker('price_lists', 'Price lists')
  ->multiple()
  ->minSelections(2) // Reject fewer than two paths.
  ->maxSelections(3); // Reject more than three paths.