first commit

Author: jmrashed

.env.example

@@ -0,0 +1,16 @@
+APP_NAME="Raw PHP API"
+APP_ENV=local
+APP_DEBUG=true
+APP_URL=http://localhost:8000
+
+DB_HOST=localhost
+DB_PORT=3306
+DB_DATABASE=test_db
+DB_USERNAME=root
+DB_PASSWORD=
+
+JWT_SECRET=your-secret-key-here
+JWT_EXPIRE=3600
+
+CACHE_DRIVER=file
+LOG_LEVEL=debug

.gitignore

@@ -0,0 +1,10 @@
+/vendor/
+/storage/logs/*.log
+/storage/cache/*
+/storage/sessions/*
+/storage/uploads/*
+.env
+composer.lock
+*.log
+.DS_Store
+Thumbs.db

Dockerfile

@@ -0,0 +1,21 @@
+FROM php:8.1-apache
+
+# Install PHP extensions
+RUN docker-php-ext-install pdo pdo_mysql
+
+# Enable Apache mod_rewrite
+RUN a2enmod rewrite
+
+# Copy application files
+COPY . /var/www/html/
+
+# Set permissions
+RUN chown -R www-data:www-data /var/www/html/storage
+RUN chmod -R 755 /var/www/html/storage
+
+# Set document root
+ENV APACHE_DOCUMENT_ROOT /var/www/html/public
+RUN sed -ri -e 's!/var/www/html!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/sites-available/*.conf
+RUN sed -ri -e 's!/var/www/!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/apache2.conf /etc/apache2/conf-available/*.conf
+
+EXPOSE 80

README.md

@@ -0,0 +1,189 @@
+# PHP REST API Pro Kit
+
+A production-ready Raw PHP REST API Starter Kit with JWT authentication, user management, file uploads, caching, rate limiting, and Docker support.
+
+[![PHP Version](https://img.shields.io/badge/PHP-8.0%2B-blue.svg)](https://php.net)
+[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![Docker](https://img.shields.io/badge/Docker-Ready-blue.svg)](docker-compose.yml)
+
+## 🚀 Features
+
+- ✅ **JWT Authentication** - Secure token-based authentication
+- ✅ **User Management** - Complete CRUD operations
+- ✅ **File Upload/Download** - Secure file handling
+- ✅ **Rate Limiting** - API request throttling
+- ✅ **Input Validation** - Request data validation
+- ✅ **Caching System** - File-based caching
+- ✅ **Error Handling** - Centralized error management
+- ✅ **Logging** - Request/error logging
+- ✅ **Health Checks** - System monitoring
+- ✅ **Docker Support** - Containerized deployment
+- ✅ **PHPUnit Testing** - Comprehensive test suite
+- ✅ **API Documentation** - Complete endpoint docs
+
+## 📁 Project Structure
+
+```
+├── app/
+│   ├── config/          # Configuration files
+│   ├── controllers/     # Request handlers
+│   ├── core/           # Core framework classes
+│   ├── database/       # Migrations and seeders
+│   ├── exceptions/     # Exception handlers
+│   ├── helpers/        # Utility classes
+│   ├── middleware/     # Request middleware
+│   ├── models/         # Data models
+│   ├── routes/         # Route definitions
+│   ├── services/       # Business logic
+│   └── tests/          # Test files
+├── bootstrap/          # Application bootstrap
+├── docs/              # API documentation
+├── public/            # Web server document root
+├── storage/           # Logs, cache, uploads
+└── vendor/            # Composer dependencies
+```
+
+## ⚡ Quick Start
+
+### 1. Clone Repository
+```bash
+git clone https://github.com/jmrashed/php-rest-api-pro-kit.git
+cd php-rest-api-pro-kit
+composer install
+```
+
+### 2. Environment Setup
+```bash
+cp .env.example .env
+# Edit .env with your database credentials
+```
+
+### 3. Database Setup
+```bash
+# Import the database schema
+mysql -u root -p < app/database/Database.sql
+```
+
+### 4. Start Development Server
+```bash
+# PHP Built-in Server
+php -S localhost:8000 -t public
+
+# Or with Docker
+docker-compose up -d
+```
+
+### 5. Test the API
+```bash
+curl http://localhost:8000/api/health
+```
+
+## 📚 API Endpoints
+
+### Authentication
+- `POST /api/auth/register` - Register new user
+- `POST /api/auth/login` - Login user
+- `POST /api/auth/logout` - Logout user
+
+### Users (Protected)
+- `GET /api/users` - Get all users (paginated)
+- `GET /api/users/{id}` - Get user by ID
+- `POST /api/users` - Create user
+- `PUT /api/users/{id}` - Update user
+- `DELETE /api/users/{id}` - Delete user
+
+### Files (Protected)
+- `POST /api/files/upload` - Upload file
+- `DELETE /api/files/{id}` - Delete file
+
+### System
+- `GET /api/health` - Health check
+- `GET /api/health/info` - System info
+
+### Example Usage
+```bash
+# Register
+curl -X POST http://localhost:8000/api/auth/register \
+  -H "Content-Type: application/json" \
+  -d '{"name":"John Doe","email":"john@example.com","password":"password123"}'
+
+# Login
+curl -X POST http://localhost:8000/api/auth/login \
+  -H "Content-Type: application/json" \
+  -d '{"email":"john@example.com","password":"password123"}'
+
+# Get users (with token)
+curl -X GET http://localhost:8000/api/users \
+  -H "Authorization: Bearer YOUR_JWT_TOKEN"
+```
+
+## 🏗️ Architecture
+
+### Core Components
+- **Application**: Main app bootstrap and container
+- **Router**: URL routing and middleware pipeline
+- **Request/Response**: HTTP abstraction layer
+- **Database**: PDO wrapper with query builder
+- **Authentication**: JWT-based auth system
+- **Cache**: File-based caching system
+- **Validation**: Input validation and sanitization
+
+### Security Features
+- Password hashing (bcrypt)
+- JWT token authentication
+- Rate limiting (60 requests/hour per IP)
+- Input sanitization and validation
+- CORS middleware
+- SQL injection protection (prepared statements)
+
+## 🧪 Testing
+
+```bash
+# Run all tests
+vendor/bin/phpunit
+
+# Run specific test
+vendor/bin/phpunit app/tests/Unit/UserTest.php
+```
+
+## 🐳 Docker Deployment
+
+```bash
+# Build and run
+docker-compose up -d
+
+# View logs
+docker-compose logs -f app
+
+# Stop services
+docker-compose down
+```
+
+## 🛠️ Requirements
+
+- PHP 8.0+
+- MySQL 5.7+
+- Composer
+- Docker (optional)
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit changes (`git commit -m 'Add amazing feature'`)
+4. Push to branch (`git push origin feature/amazing-feature`)
+5. Open Pull Request
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 👨‍💻 Author
+
+**Md Rashedul Islam**
+- GitHub: [@jmrashed](https://github.com/jmrashed)
+- LinkedIn: [Md Rashedul Islam](https://linkedin.com/in/jmrashed)
+
+## ⭐ Show your support
+
+Give a ⭐️ if this project helped you!

app/config/database.php

@@ -0,0 +1,12 @@
+<?php
+$servername = "localhost";
+$username   = "root";
+$password   = "";
+$database   = "test_db";
+
+$conn = new mysqli($servername, $username, $password, $database);
+
+if ($conn->connect_error) {
+    die("Connection failed: " . $conn->connect_error);
+}
+// echo "Connected successfully to test_db"; // Removed echo for API context

app/config/env.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace App\Config;
+
+class Env
+{
+    protected static $variables = [];
+
+    public static function load($path)
+    {
+        if (!file_exists($path)) {
+            throw new \Exception("Environment file not found at {$path}");
+        }
+
+        $lines = file($path, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
+        foreach ($lines as $line) {
+            if (strpos(trim($line), '#') === 0) {
+                continue;
+            }
+
+            list($name, $value) = explode('=', $line, 2);
+            self::$variables[trim($name)] = trim($value);
+        }
+    }
+
+    public static function get($key, $default = null)
+    {
+        return self::$variables[$key] ?? $default;
+    }
+}

app/controllers/AuthController.php

@@ -0,0 +1,62 @@
+<?php
+
+namespace App\Controllers;
+
+use App\Core\Controller;
+use App\Core\Response;
+use App\Services\AuthService;
+
+class AuthController extends Controller
+{
+    private $authService;
+
+    public function __construct()
+    {
+        $this->authService = new AuthService();
+    }
+
+    public function login()
+    {
+        $data = $this->getRequestData();
+        
+        if (!isset($data['email']) || !isset($data['password'])) {
+            return Response::json(['error' => 'Email and password required'], 400);
+        }
+
+        $result = $this->authService->login($data['email'], $data['password']);
+        
+        if ($result) {
+            return Response::json($result);
+        }
+        
+        return Response::json(['error' => 'Invalid credentials'], 401);
+    }
+
+    public function register()
+    {
+        $data = $this->getRequestData();
+        
+        if (!isset($data['name']) || !isset($data['email']) || !isset($data['password'])) {
+            return Response::json(['error' => 'Name, email and password required'], 400);
+        }
+
+        $result = $this->authService->register($data);
+        
+        if ($result) {
+            return Response::json($result, 201);
+        }
+        
+        return Response::json(['error' => 'Registration failed'], 400);
+    }
+
+    public function logout()
+    {
+        $token = $this->getBearerToken();
+        
+        if ($token) {
+            $this->authService->logout($token);
+        }
+        
+        return Response::json(['message' => 'Logged out successfully']);
+    }
+}