> For the complete documentation index, see [llms.txt](https://quantumphp.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://quantumphp.gitbook.io/docs/packages/app/helpers.md).
# Helpers
The App package loads a small set of global helpers early in boot.
Use them for runtime paths and a few framework-level utility tasks.
## Path helpers
These helpers all depend on `App::getContext()` already being initialized.
### `base_dir()`
Returns the project root passed into `AppFactory::create()`.
### `logs_dir()`
Returns `/logs`.
### `framework_dir()`
Returns `/vendor/quantum/framework/src`.
Use it when you need the installed framework source tree, such as console command discovery.
### `modules_dir(?string $moduleDir = null)`
Returns the provided argument when one is supplied.
Otherwise it returns `/modules`.
That makes it useful both for default module lookup and for callers that want to override the module root explicitly.
### `public_dir()`, `uploads_dir()`, `assets_dir()`, `hooks_dir()`
These resolve to:
* `/public`
* `/public/uploads`
* `/public/assets`
* `/hooks`
## File and class helpers
### `deleteDirectoryWithFiles(string $dir)`
Recursively deletes a directory and everything under it.
Use it carefully. This helper calls `unlink()` and `rmdir()` directly.
Behavior that matters:
* returns `false` when the path is not a directory
* returns the result of the final `rmdir()` call for real directories
* does not move anything to trash
### `get_directory_classes(string $path)`
Returns PHP filenames from a directory tree without namespaces.
Use it for simple discovery by class file name, not for fully qualified class resolution.
## Utility helpers
### `uuid_random()` and `uuid_ordered()`
* `uuid_random()` returns a UUID v4 string
* `uuid_ordered()` returns a UUID v1 string
### `slugify(string $text)`
Creates a lowercase dash-separated slug.
When the result would be empty or exactly `0`, it returns `n-a`.
### `random_number(int $length = 10)`
Builds a random numeric sequence and returns it as an integer.
Because the result is cast to `int`, this helper is not a good fit when leading zeroes must be preserved.
### `valid_base64(string $string)`
Returns `true` only when the string matches the package's base64 validation pattern and round-trips through `base64_decode(..., true)`.
### `is_debug_mode()`
Reads `config('app.debug')` and validates it as a boolean flag.
### `export($var)`
Exports a PHP value through Symfony VarExporter.
Use it when you need framework-generated PHP-safe value output instead of JSON.
## Internal helper
`_message()` is the package's placeholder-replacement helper for exception messages.
It is framework plumbing, not a typical application-level helper.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://quantumphp.gitbook.io/docs/packages/app/helpers.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.