Path Constants

Prisma PHP defines a set of global constants to ensure consistent file referencing. These absolute paths prevent "directory hell" (../../) and ensure your application works identically across different server environments.

Available Constants

DOCUMENT_PATH

The project root directory.

/var/www/project
APP_PATH

The main application logic entry point.

/var/www/project/src/app
PUBLIC_PATH

The web root (accessible via browser).

/var/www/project/public
SETTINGS_PATH

Configuration files directory.

/var/www/project/settings
SRC_PATH

Source code root.

/var/www/project/src
LIB_PATH

Shared libraries and utilities.

/var/www/project/src/Lib
PRISMA_LIB_PATH

Core framework files.

/var/www/project/src/Lib/Prisma

Usage Examples

Including Files

Always use constants instead of relative paths to avoid breakage when moving files.

<?php
// Bad
require_once '../../settings/config.php';

// Good
require_once SETTINGS_PATH . '/config.php';

// Loading a view
require_once APP_PATH . '/views/header.php';
?>

Serving Assets

<?php
// Define a path for file operations (uploading)
$uploadDir = PUBLIC_PATH . '/uploads';

// Define a URL for the browser
$imageUrl = '/uploads/avatar.jpg'; 
?>