hamzasarfraz862/backend-app repository overview

⁠Mxmobilz API

Production backend for the Mxmobilz mobile-phone e-commerce platform.

A pure JSON REST API built with Laravel 13 and PHP 8.3-FPM. The application is designed to run behind Nginx and connect to MySQL.

⁠Tech Stack

• Laravel 13
• PHP 8.3
• PHP-FPM
• Composer 2.8
• Nginx
• MySQL 8.4 / Amazon RDS
• Docker
• Debian Bookworm

⁠Production Architecture

The backend follows a production-oriented container architecture:

Nginx ↓ PHP-FPM ↓ Laravel 13 API ↓ MySQL / RDS

Redis can be used for caching, queues and other application workloads.

⁠Docker Build

The image uses a multi-stage Docker build:

Composer 2.8 ↓ Install optimized PHP dependencies ↓ PHP 8.3-FPM Bookworm ↓ Copy Laravel application ↓ Run as non-root www-data ↓ PHP-FPM on port 9000

Development dependencies are excluded from the production image.

Composer is configured with:

• --no-dev
• --no-interaction
• --optimize-autoloader
• classmap-authoritative

⁠Key Features

• Laravel 13 JSON REST API
• PHP 8.3-FPM runtime
• Multi-stage Docker build
• Composer dependency optimization
• OPcache enabled
• MySQL support
• Required PHP extensions including:
  • PDO MySQL
  • GD
  • ZIP
  • OPcache
• Non-root runtime user
• Production-oriented image
• Secrets supplied through environment variables
• Compatible with Docker Compose and Kubernetes

⁠API Endpoints

Main API resources include:

/api/products
/api/orders
/api/inquiries
/api/promos
/api/stats