Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/carthage-software/elissa-bundle
Elissa Bundle by Carthage brings out-of-the-box PSR-7 and PSR-15 support to your Symfony project.
https://github.com/carthage-software/elissa-bundle
psr-15 psr-7 symfony symfony-bundle zero-config
Last synced: about 1 month ago
JSON representation
Elissa Bundle by Carthage brings out-of-the-box PSR-7 and PSR-15 support to your Symfony project.
- Host: GitHub
- URL: https://github.com/carthage-software/elissa-bundle
- Owner: carthage-software
- License: mit
- Created: 2023-07-26T15:38:29.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-07-26T19:20:32.000Z (over 1 year ago)
- Last Synced: 2024-09-30T16:21:16.574Z (about 1 month ago)
- Topics: psr-15, psr-7, symfony, symfony-bundle, zero-config
- Language: PHP
- Homepage:
- Size: 29.3 KB
- Stars: 22
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Elissa Bundle - PSR-7 & PSR-15 Made Easy!
Elissa Bundle by Carthage brings out-of-the-box PSR-7 and PSR-15 support to your Symfony project.
The package allows developers to write PSR-15 handlers and middleware, which are auto-tagged and ready to use as controllers.
It also provides ready access to all PSR-7 factories, and enables seamless integration of middleware from third-party vendor packages.
## Installation 🚀
Install the Elissa Bundle using Composer with the following command:
```bash
composer require carthage/elissa-bundle
```
## Enabling the Bundle 🎚
To enable the bundle in your Symfony project, add the following line in the `config/bundles.php` file:
```php
return [
//...
Carthage\ElissaBundle\ElissaBundle::class => ['all' => true],
//...
];
```
## Usage 💼
### PSR-7 Factories 🏭
The Elissa Bundle comes with autowired and pre-configured PSR-7 factories. You can conveniently create PSR-7 objects in your services without any extra configuration.
```php
streamFactory->createStream('Hello World!');
return $this->responseFactory->createResponse(200)
->withBody($body);
}
}
```
### PSR-15 Middleware 🛠
Just like handlers, you can write PSR-15 middleware, and they will automatically function.
```php
handle($request);
return $response->withHeader('X-Made-With', 'Love');
}
}
```
### Configurations ⚙
The Elissa Bundle is designed to minimize configuration, but if you need to register additional PSR-15 middlewares from third-party vendors, you can use the `elissa.middleware` service tag.
```yaml
# config/services.yaml
services:
Some\External\ServiceMiddleware:
tags:
- { name: elissa.middleware }
```
## Code Of Conduct 🤝
Our community is guided by a Code of Conduct, and we expect all contributors to respect it. See the [`CODE_OF_CONDUCT`](./CODE_OF_CONDUCT.md) for more details.
## Contributing 🎁
The Elissa Bundle thrives on contributions from the open-source community. We value every contribution, no matter how small.
## License 📜
The Elissa Bundle is distributed under the MIT License. See [`LICENSE`](./LICENSE) for more information.
---
We hope you enjoy using the Elissa Bundle! For any queries or suggestions, don't hesitate to open an issue or submit a pull request. Happy coding!