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, benchmark 2 and benchmark 3
Use with Swoole
Flat files and plain-old PHP functions rocking on a production-grade, high-performance, scalable, concurrent and non-blocking HTTP server.
Getting started
Installation
$ 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!
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
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.
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:
composer require webonyx/graphql-php
Schema-first
type Query {
hello: String
}
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:
composer require doctrine/annotations
Then:
/**
* @\Siler\GraphQL\Annotation\ObjectType()
*/
final class Query
{
/**
* @\Siler\GraphQL\Annotation\Field()
*/
static public function hello($root, $args, $context, $info): string
{
return 'Hello, World!';
}
}
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?
License
- MIT license
- Copyright 2020 © LC
72 Aug 21, 2022
3 Jul 24, 2022
216 Dec 8, 2022
6 Jul 3, 2022
3.6k Dec 22, 2022
415 Dec 27, 2022
53 Sep 13, 2022
20 Dec 16, 2022
15 Jul 28, 2022
0 Apr 6, 2022
1.8k Jan 5, 2023
19 Dec 10, 2020
1 Nov 23, 2020
312 Dec 30, 2022
128 Dec 22, 2022
695 Dec 26, 2022
82 Dec 31, 2022
24 Dec 6, 2022
136 Jan 4, 2023