Before setting up CashMan H.A., verify that your server or local development environment satisfies all of the following prerequisites. The platform is built on PHP 8.1 with an MVC architecture and relies on a MySQL-compatible database for its 21 tables, stored procedures, triggers, views, and scheduled events. Meeting every requirement listed below ensures the application boots correctly and all features — including automated email notifications, loan processing, and savings account transfers — work as expected.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/DanielRivera03/SistemaBancario/llms.txt
Use this file to discover all available pages before exploring further.
Server Requirements
PHP 8.1+
CashMan H.A. requires PHP version 8.1 or later. Older PHP versions are not supported.
MySQL or MariaDB
A MySQL-compatible database server is required. The application has been tested with MariaDB 10.4.24.
Apache or Nginx
Any standard web server capable of serving PHP applications. Apache with
mod_rewrite or Nginx with a compatible rewrite rule is recommended.Composer
PHP dependency manager used to install the router and number-formatting libraries. Install from getcomposer.org.
Required PHP Extensions
The following PHP extensions must be enabled in yourphp.ini before running the application:
| Extension | Purpose |
|---|---|
mysqli | Primary database driver — all eight MySQLi connections (one primary and seven auxiliary) use this extension |
mbstring | Multibyte string handling for name and text fields |
openssl | Required by PHPMailer for SMTP TLS/SSL connections |
fileinfo | Used for file-type validation when handling uploads and PDF generation |
Composer Dependencies
TheCashManHA/composer.json declares two runtime dependencies that are installed via composer install:
| Package | Version | Purpose |
|---|---|---|
bramus/router | ~1.6 | Lightweight PHP router that handles all MVC route definitions |
luecano/numero-a-letras | ^3.0 | Converts numeric amounts to written words (used in loan contracts and PDF receipts) |
Development Tools
For local development, the project is pre-configured to send transactional emails (password recovery codes, transfer security codes, credential update confirmations) through Papercut SMTP — a local SMTP sink that captures outgoing mail without delivering it.- Papercut SMTP — github.com/ChangemakerStudios/Papercut-SMTP
- Default configuration:
Hostis left blank (localhost),Port = 2525
The default server port hardcoded throughout the codebase is 90 (
http://localhost:90/). If your web server listens on a different port (e.g., the standard port 80), you must update the $UrlGlobal variable and the CSS import URLs before the application will load styles or process redirects correctly. See the Installation guide for the exact files and lines to change.