dir

Creates a directory object.

Target type

Signature

1dir(path::string, -resolveLinks=false)

Creates a directory object.

dir constructs or identifies a LaiRu value type. dir touches paths or filesystem data. Resolve paths deliberately and avoid mixing visitor-provided path fragments with trusted server paths without validation.

Parameters

path: Required value of type string. Supply path positionally unless the signature shows a keyword form.
-resolveLinks: Optional value. Supply -resolveLinks by keyword, keeping the leading hyphen in the call.

In web-serving modes, request-targeted application file access cannot escape the configured document_root. That boundary can come from the .ini file, the --docroot flag used by the LaiRu HTTP server or FPM process, or FastCGI values such as DOCUMENT_ROOT and SCRIPT_FILENAME supplied by nginx or Apache. See the directory">web root directory, FastCGI options, and LaiRu FPM pages for the deployment side of that boundary.

Examples

Basic call

1dir('/tmp')

The example assumes a trusted path. Validate or resolve any path built from visitor input.

List files beneath a configured directory

1[2local(root) = dir('/var/www/html/assets')3if(#root->exists) => {4    #root->eachFilePath => {5        local(f) = file(#1)6        #f->path + ' ' + #f->size + '\n'7    }8}9]

Directory traversal should start from a known server-side root, not from an unchecked visitor-supplied path.

Recursive traversal with an explicit base

1[2local(base) = '/var/www/html/content'3dir(#base)->eachPathRecursive => {4    local(path) = string(#1)5    if(not #path->contains('/.')) => {6        #path + '\n'7    }8}9]

When walking recursively, keep the base path explicit and filter hidden or generated directories deliberately.

dir