Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/leocavalcante/siler
⚡ Flat-files and plain-old PHP functions rockin'on as a set of general purpose high-level abstractions.
https://github.com/leocavalcante/siler
flat-files functional graphql hacktoberfest http http2 library micro-framework php psalm psr-11 psr-15 psr-2 psr-4 psr-7 routing siler swoole websockets
Last synced: 3 months ago
JSON representation
⚡ Flat-files and plain-old PHP functions rockin'on as a set of general purpose high-level abstractions.
- Host: GitHub
- URL: https://github.com/leocavalcante/siler
- Owner: leocavalcante
- License: mit
- Archived: true
- Created: 2016-12-02T02:01:48.000Z (about 8 years ago)
- Default Branch: main
- Last Pushed: 2022-02-13T14:04:09.000Z (almost 3 years ago)
- Last Synced: 2024-09-21T20:32:40.111Z (3 months ago)
- Topics: flat-files, functional, graphql, hacktoberfest, http, http2, library, micro-framework, php, psalm, psr-11, psr-15, psr-2, psr-4, psr-7, routing, siler, swoole, websockets
- Language: PHP
- Homepage: https://siler.leocavalcante.dev
- Size: 5.81 MB
- Stars: 1,117
- Watchers: 50
- Forks: 90
- Open Issues: 28
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-graphql - Siler - Plain-old functions providing a declarative API for GraphQL servers with Subscriptions support. (Libraries / PHP Libraries)
- awesome-swoole - Siler - A set of general purpose high-level abstractions aiming an API for declarative programming in PHP. Note: This repository has been archived by the owner. (Frameworks)
- awesome-swoole - Siler - Flat files and plain-old PHP functions rocking on a production-grade, high-performance, scalable, concurrent and non-blocking HTTP server. (Framework)
- awesome-graphql - Siler - Plain-old functions providing a declarative API for GraphQL servers with Subscriptions support. (Libraries / PHP Libraries)
- awesome-made-by-brazilians - Siler
README
> ⚠️ I'm afraid that I'm not being able to keep Siler up-to-date as it deserves, so it's repository has been archived.
**As an alternative for Siler, something lightweight and simple that works as a library with Swoole out-of-the-box, I highly recommend Nano!
Check it out: https://nano.hyperf.wiki/#/en/**
---
[](https://github.com/leocavalcante/siler/actions)
[](https://codecov.io/gh/leocavalcante/siler)
[](https://shepherd.dev/github/leocavalcante/siler)
[](https://packagist.org/packages/leocavalcante/siler)
[](https://packagist.org/packages/leocavalcante/siler)
[](https://packagist.org/packages/leocavalcante/siler)
Siler is a set of general purpose high-level abstractions aiming an API for declarative programming in PHP.
* 💧 **Files and functions** as first-class citizens
* 🔋 **Zero dependency**, everything is on top of PHP built-in functions
* ⚡ **Blazing fast**, no additional overhead - [*benchmark 1*](https://github.com/kenjis/php-framework-benchmark#results), [*benchmark 2*](https://qiita.com/prograti/items/01eac3d20f1447a7b2f9) and [*benchmark 3*](https://github.com/the-benchmarker/web-frameworks)
## Use with [Swoole](https://www.swoole.co.uk/)
Flat files and plain-old PHP functions rocking on a production-grade, high-performance, scalable, concurrent and non-blocking HTTP server.
[Read the tutorial.](https://siler.leocavalcante.com/swoole)
## Getting started
### Installation
```bash
composer require leocavalcante/siler
```
That is it. Actually, Siler is a library, not a framework (maybe a micro-framework), the overall program flow of control is dictated by you. So, no hidden configs or predefined directory structures.
### Hello, World!
```php
use Siler\Functional as λ; // Just to be cool, don't use non-ASCII identifiers ;)
use Siler\Route;
Route\get('/', λ\puts('Hello, World!'));
```
Nothing more, nothing less. You don't need even tell Siler to `run` or something like that (`puts` works like a lazily evaluated `echo`).
#### JSON
```php
use Siler\Route;
use Siler\Http\Response;
Route\get('/', fn() => Response\json(['message' => 'Hello, World!']));
```
The `Response\json` function will automatically add `Content-type: application/json` in the response headers.
### Swoole
Siler provides first-class support for Swoole. You can regularly use `Route`, `Request` and `Response` modules for a Swoole HTTP server.
```php
use Siler\Http\Response;
use Siler\Route;
use Siler\Swoole;
$handler = function () {
Route\get('/', fn() => Response\json('Hello, World!'));
};
$port = 8000;
echo "Listening on port $port\n";
Swoole\http($handler, $port)->start();
```
### GraphQL
Install peer-dependency:
```bash
composer require webonyx/graphql-php
```
#### Schema-first
```graphql
type Query {
hello: String
}
```
```php
use Siler\Route;
use Siler\GraphQL;
$type_defs = file_get_contents(__DIR__ . '/schema.graphql');
$resolvers = [
'Query' => [
'hello' => fn ($root, $args, $context, $info) => 'Hello, World!'
]
];
$schema = GraphQL\schema($type_defs, $resolvers);
Route\post('/graphql', fn() => GraphQL\init($schema));
```
#### Code-first
Another peer-dependency:
```bash
composer require doctrine/annotations
```
Then:
```php
/**
* @\Siler\GraphQL\Annotation\ObjectType()
*/
final class Query
{
/**
* @\Siler\GraphQL\Annotation\Field()
*/
public static function hello($root, $args, $context, $info): string
{
return 'Hello, World!';
}
}
```
```php
use Siler\GraphQL;
use Siler\Route;
$schema = GraphQL\annotated([Query::class]);
Route\post('/graphql', fn() => GraphQL\init($schema));
```
Object type name will be guessed from class name, same for field name, and it's return type (i.e.: PHP `string` scalar `===` GraphQL `String` scalar).
## What is next?
- [Documentation](https://siler.leocavalcante.dev/)
- [Examples](https://github.com/siler-examples)
## License
[](https://github.com/leocavalcante/siler/blob/master/LICENSE)
- **[MIT license](http://opensource.org/licenses/mit-license.php)**
- Copyright 2020 © LC