https://github.com/ehab-elshimi/native-doctrine-orm

Minimal backend built with native PHP 8 and Doctrine ORM, focusing on clean structure and real fundamentals.
https://github.com/ehab-elshimi/native-doctrine-orm

backend datamapper dependency-injection doctrine doctrine-dbal doctrine-orm enterprise-solutions europe european-job-search european-union mvc-architecture mysql-database native-php open-jobs php repository-service-api-pattern service-container software-development

Last synced: about 1 month ago
JSON representation

Minimal backend built with native PHP 8 and Doctrine ORM, focusing on clean structure and real fundamentals.

• Host: GitHub
• URL: https://github.com/ehab-elshimi/native-doctrine-orm
• Owner: ehab-elshimi
• License: mit
• Created: 2025-11-11T14:05:46.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2025-11-21T15:53:06.000Z (7 months ago)
• Last Synced: 2026-02-19T22:41:00.005Z (4 months ago)
• Topics: backend, datamapper, dependency-injection, doctrine, doctrine-dbal, doctrine-orm, enterprise-solutions, europe, european-job-search, european-union, mvc-architecture, mysql-database, native-php, open-jobs, php, repository-service-api-pattern, service-container, software-development
• Language: PHP
• Homepage:
• Size: 35.2 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Doctrine Category–Product Mini Framework

A **small PHP project** built with **native PHP 8+**, **Doctrine ORM**, and a **custom dependency injection container**, without relying on Laravel or Symfony.  

It demonstrates **basic backend architecture**, including **entity relationships, simple API handling, and data filtering**.  

This project is intended to **showcase real backend skills** in PHP and Doctrine for **European backend opportunities**, focusing on clean, maintainable, and framework-independent code.

---

## ✅ Project Highlights

* **Native PHP & Doctrine Mastery**

  * Full control of entity mapping using **Doctrine Attributes**

  * One-to-Many and Many-to-One relationships without relying on a framework

  * Repository pattern and advanced QueryBuilder usage

  * Filtering using Doctrine **Criteria**, **Collection filters**, and **custom queries**

* **Custom Dependency Injection Container**

  * Handmade container showing understanding of DI principles

  * Lazy-loaded services and controllers

  * Clean separation between business logic and routing

* **Services & Controllers Layered Architecture**

  * `CategoryService` and `ProductService` contain business logic

  * Controllers handle only requests and output, keeping code modular

* **Caching with Symfony Cache Adapter**

  * Caching categories and products for performance

  * Debug routes to inspect cached data

* **Multiple Filtering Techniques for Products**

  1. **QueryBuilder** – database-level filtering

  2. **Collection filter** – in-memory PHP filtering

  3. **Doctrine Criteria** – reusable and expressive filters

* **Clean, Minimal, Readable Code**

  * No boilerplate from Laravel/Symfony

  * Focus on **real-world backend architecture and native PHP skills**

---

## 📁 Project Structure

```

src/

 └── App/

      ├── Controllers/

      │     ├── CategoryController.php

      │     └── ProductController.php

      ├── Services/

      │     ├── CategoryService.php

      │     └── ProductService.php

      ├── Entity/

      │     ├── Category.php

      │     └── Product.php

      ├── Repository/

      │     ├── CategoryRepository.php

      │     └── ProductRepository.php

      └── Core/

            └── Container.php   ← handcrafted DI container

config/

 └── bootstrap.php             ← container setup + services registration

 index.php                 ← front controller with routing

```

---

## 🛠 Requirements

* **PHP ≥ 8.1** (native features & attributes)

* Composer

* MySQL / MariaDB

* Doctrine ORM (installed via Composer)

---

## 📦 Installation

1. Clone repository:

```bash

git clone https://github.com/your-username/native-doctrine-orm.git

cd native-doctrine-orm

```

2. Install dependencies:

```bash

composer install

```

3. Configure your database in `config/bootstrap.php`.

4. Generate database tables:

```bash

vendor/bin/doctrine orm:schema-tool:update --force

```

5. Start local server:

```bash

php -S localhost:8000

```

Open in browser: `http://localhost:8000`

---

## 🧭 Available Routes

### Categories

| Route                                   | Description                             |

| --------------------------------------- | --------------------------------------- |

| `?uri=categories`                       | List all categories                     |

| `?uri=category-detail&name=Electronics` | Show a single category                  |

| `?uri=category-prices1`                 | Filter products (QueryBuilder)          |

| `?uri=category-prices2`                 | Filter products (PHP Collection filter) |

| `?uri=category-prices3`                 | Filter products (Doctrine Criteria)     |

| `?uri=cache-debug`                      | Inspect cached category cache           |

### Products

| Route                                     | Description                         |

| ----------------------------------------- | ----------------------------------- |

| `?uri=products`                           | List all products                   |

| `?uri=product-detail&product_id=1`        | Show single product                 |

| `?uri=products-by-category&category_id=3` | Products in a category              |

| `?uri=products-by-price&min=5000`         | Products above minimum price        |

| `?uri=products-with-category`             | Join products with their categories |

---

## 🎯 Why This Project Matters for European Recruiters

* **Native PHP & Doctrine skills** – you demonstrate mastery of backend without frameworks

* **Clean architecture** – services, controllers, repositories, and DI container

* **Scalable & maintainable** – shows understanding of real enterprise projects

* **Problem-solving mindset** – multiple filtering solutions, caching, and entity relationships

---

## 🧠 Learning Purpose

* Deep understanding of **Doctrine ORM internals** (Unit of Work, Proxies, Repositories)  

* Building **MVC applications from scratch** using native PHP  

* Designing **scalable, maintainable backend systems** with clean architecture  

* Implementing **AI-powered workflow automation** and intelligent backend processes  

* Developing robust **APIs and integration with 3rd-party services**  

* Preparing for **open Backend PHP roles in the European Union**, showcasing native PHP, automation, and API skills

---

## 🤝 Contributions

* Extend entities and relationships

* Add custom router or event system

* Implement autowiring for the container

* Add tests and CI/CD pipelines