PHPackages                             juzdy/juzdy - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP &amp; Networking](/categories/http)
4. /
5. juzdy/juzdy

ActiveProject[HTTP &amp; Networking](/categories/http)

juzdy/juzdy
===========

Easy start http project

1.0.2(5mo ago)26PHPPHP &gt;=8.0

Since Jan 15Pushed 5mo agoCompare

[ Source](https://github.com/juzdy/juzdy)[ Packagist](https://packagist.org/packages/juzdy/juzdy)[ RSS](/packages/juzdy-juzdy/feed)WikiDiscussions main Synced 3mo ago

READMEChangelog (3)Dependencies (1)Versions (6)Used By (0)

Juzdy - PHP Project Template
============================

[](#juzdy---php-project-template)

A modern, lightweight PHP project template built on the [Juzdy Core](https://github.com/juzdy/core) framework. Get started quickly with a clean architecture, dependency injection, PSR-compliance, and event-driven design.

🚀 Quick Start
-------------

[](#-quick-start)

### Prerequisites

[](#prerequisites)

- PHP &gt;= 8.0
- Composer
- MySQL (optional, for database functionality)

### Installation

[](#installation)

1. **Clone or use this template:**

    ```
    composer create-project juzdy/juzdy my-project
    cd my-project
    ```
2. **Install dependencies:**

    ```
    composer install
    ```
3. **Start the development server:**

    ```
    php -S localhost:8000 -t pub
    ```
4. **Visit your application:**Open  in your browser. You should see "Hello from Index Handler!"

### Using Docker

[](#using-docker)

For a complete development environment with PHP and MySQL:

```
./bin/docker-start.sh
```

Visit  to see your application. See [DOCKER.md](DOCKER.md) for more details.

📖 Documentation
---------------

[](#-documentation)

Complete documentation is available in the [doc/](doc/) directory:

- **[Getting Started](doc/getting-started.md)** - Installation and first steps
- **[Architecture](doc/architecture.md)** - Understanding the framework structure
- **[Configuration](doc/configuration.md)** - Managing application configuration
- **[HTTP Handlers](doc/http-handlers.md)** - Creating request handlers and routes
- **[Middleware](doc/middleware.md)** - Using and creating middleware
- **[Database](doc/database.md)** - Working with models and database
- **[Layouts &amp; Views](doc/layouts.md)** - Template rendering and assets
- **[Docker Development](DOCKER.md)** - Docker setup and workflow
- **[Deployment](doc/deployment.md)** - Deploying to production
- **[Examples](doc/examples.md)** - Code examples and patterns

✨ What's Included
-----------------

[](#-whats-included)

This template provides a ready-to-use structure with:

- ✅ **HTTP Request Handling** - PSR-15 middleware and routing
- ✅ **Dependency Injection** - Advanced DI container with attributes
- ✅ **Configuration System** - Flexible, file-based configuration
- ✅ **Error Handling** - Built-in error handler with custom pages
- ✅ **Layout System** - Template rendering with asset management
- ✅ **Docker Support** - Complete Docker development environment
- ✅ **PSR Compliance** - Following PHP standards (PSR-4, PSR-11, PSR-14, PSR-15)

📁 Project Structure
-------------------

[](#-project-structure)

```
juzdy/
├── app/                      # Application code
│   ├── layout/              # View templates
│   │   ├── default/         # Default layout templates
│   │   └── errors/          # Error page templates
│   └── src/                 # Source code
│       └── Http/            # HTTP layer
│           └── Handler/     # Request handlers
├── bin/                     # Executable scripts
├── doc/                     # Documentation
├── etc/                     # Configuration
│   └── config/             # Config files
│       ├── config.php      # Main configuration
│       ├── db.php          # Database configuration
│       ├── layout.php      # Layout configuration
│       └── middleware.php  # Middleware configuration
├── pub/                     # Public directory (web root)
│   ├── .htaccess           # Apache rewrite rules
│   └── index.php           # Application entry point
├── var/                     # Variable data (logs, cache)
├── composer.json            # Dependencies
└── README.md               # This file

```

🎯 Core Features
---------------

[](#-core-features)

### Request Handlers

[](#request-handlers)

Create HTTP handlers by extending the base `Handler` class:

```
namespace App\Http\Handler;

use Juzdy\Http\Handler;
use Juzdy\Http\RequestInterface;
use Juzdy\Http\ResponseInterface;

class MyHandler extends Handler
{
    public function handle(RequestInterface $request): ResponseInterface
    {
        return $this->response()
            ->header('Content-Type', 'application/json')
            ->body(json_encode(['message' => 'Hello World']));
    }
}
```

Access via: `http://localhost:8000/MyHandler`

### Middleware Pipeline

[](#middleware-pipeline)

Configure middleware in `etc/config/middleware.php`:

```
return [
    'middleware' => [
        'global' => [
            \Juzdy\Http\Middleware\CorsMiddleware::class,
            \Juzdy\Http\Router::class
        ],
    ],
];
```

### Dependency Injection

[](#dependency-injection)

Dependencies are automatically resolved:

```
class MyHandler extends Handler
{
    public function __construct(
        private MyService $service,
        private DatabaseConnection $db
    ) {}
}
```

🔗 Links
-------

[](#-links)

- **Core Framework:** [juzdy/core](https://github.com/juzdy/core)
- **Example Project:** [skibimad/http](https://github.com/skibimad/http)
- **Full Documentation:** [doc/](doc/)

📝 License
---------

[](#-license)

This project is open-sourced software licensed under the MIT license.

🤝 Contributing
--------------

[](#-contributing)

Contributions are welcome! Please feel free to submit a Pull Request.

💡 Getting Help
--------------

[](#-getting-help)

- Read the [documentation](doc/)
- Check the [examples](doc/examples.md)
- Review the [juzdy/core documentation](https://github.com/juzdy/core)
- Open an issue on GitHub

---

Built with ❤️ using [Juzdy Core](https://github.com/juzdy/core)

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance71

Regular maintenance activity

Popularity7

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 55% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

169d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/39bcfd110a5cc1f2d7ff687193670d00133cf415ad2b9959afaff24ff1e564fd?d=identicon)[vgalitsky](/maintainers/vgalitsky)

---

Top Contributors

[![vgalitsky](https://avatars.githubusercontent.com/u/1241206?v=4)](https://github.com/vgalitsky "vgalitsky (11 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (9 commits)")

### Embed Badge

![Health badge](/badges/juzdy-juzdy/health.svg)

```
[![Health](https://phpackages.com/badges/juzdy-juzdy/health.svg)](https://phpackages.com/packages/juzdy-juzdy)
```

###  Alternatives

[php-http/cache-plugin

PSR-6 Cache plugin for HTTPlug

25126.1M82](/packages/php-http-cache-plugin)[illuminate/http

The Illuminate Http package.

11937.9M6.9k](/packages/illuminate-http)[rdkafka/rdkafka

A PHP extension for Kafka

2.2k24.3k1](/packages/rdkafka-rdkafka)[httpsoft/http-message

Strict and fast implementation of PSR-7 and PSR-17

87965.9k114](/packages/httpsoft-http-message)[mezzio/mezzio-router

Router subcomponent for Mezzio

265.4M92](/packages/mezzio-mezzio-router)[serpapi/google-search-results-php

Get Google, Bing, Baidu, Ebay, Yahoo, Yandex, Home depot, Naver, Apple, Duckduckgo, Youtube search results via SerpApi.com

69127.2k](/packages/serpapi-google-search-results-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
