https://github.com/parvinshi/eagle
An extensible web framework for PHP, with useful features: dependency injection container and route, that helps you to quickly and easily build RESTful APIs and web applications.
https://github.com/parvinshi/eagle
container dependency-injection fastroute php psr-11 route routing
Last synced: 9 days ago
JSON representation
An extensible web framework for PHP, with useful features: dependency injection container and route, that helps you to quickly and easily build RESTful APIs and web applications.
- Host: GitHub
- URL: https://github.com/parvinshi/eagle
- Owner: parvinshi
- License: mit
- Created: 2019-01-02T10:15:29.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2021-03-28T05:34:54.000Z (almost 5 years ago)
- Last Synced: 2025-07-19T17:34:19.723Z (6 months ago)
- Topics: container, dependency-injection, fastroute, php, psr-11, route, routing
- Language: PHP
- Homepage:
- Size: 35.2 KB
- Stars: 6
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Eagle framework
Eagle框架实现了依赖注入容器（Dependency Injection Container）、路由（route）等组件,其它如ORM、cache、validation、filesystem等组件可以使用composer来由用户自由扩展。
# composer安装
composer require parvin/eagle-framework
# php版本要求
PHP7以上
# Route
route可以使用symfony的http foundation组件来处理HTTP消息请求（http messages）。
```php
get('/articles', function () {
return 'This is articles list';
});
$router->get('/articles/{id:\d+}', function ($id) {
return 'Article id: ' . $id;
});
/* title 为可选参数 */
$router->get('/articles/{id:\d+}[/{title}]', function ($id, $title) {
return 'Article id: ' . $id . ', title: ' . $title;
});
/*匹配处理路由组*/
$router->group('/articles', function () use ($router) {
$router->get('/list', function() {
return 'This is articles list';
});
$router->get('/detail', function ($id, $title) {
return 'Article detail id: ' . $id . ', title: ' . $title;
});
});
$request = new Request();
$routeHandler = $router->getRouteHandler();
$response = $routeHandler->handle($request);
echo $response;
```
# Container
Dependency injection Container基于PSR-11规范实现，包括3种注入实现方式：构造方法注入（Constructor Injection）、setter类方法或属性注入（Setter Injection）、匿名回调函数注入（ Closure callable Injection ）。
## 构造方法注入（Constructor Injection)
```php
bar = $bar;
}
}
/*class Bar {
}*/
class Bar {
public $baz;
public function __construct(Baz $baz)
{
$this->baz = $baz;
}
}
class Baz {
}
$container = new Container;
$container->set(Foo::class)->addArguments(Bar::class);
$container->set(Bar::class)->addArguments(Baz::class);
$foo = $container->get(Foo::class);
var_dump($foo, $foo->bar);
var_dump($foo instanceof Foo); // true
var_dump($foo->bar instanceof Bar); // true
var_dump($foo->bar->baz instanceof Baz); // true
```
## 类方法注入（ Setter Injection ）
```php
model = $model;
}
}
class Model
{
public $pdo;
public function setPdo(\PDO $pdo)
{
$this->pdo = $pdo;
}
}
$container = new Container;
$container->set(Controller::class)->addArguments(Model::class);
$container->set(Model::class)->addInvokeMethod('setPdo', [\PDO::class]);
$container->set(\PDO::class)
->addArguments(['mysql:dbname=test;host=localhost', 'root', '111111']);
$controller = $container->get(Controller::class);
var_dump($controller instanceof Controller); // true
var_dump($controller->model instanceof Model); // true
var_dump($controller->model->pdo instanceof \PDO); // true
```
## 匿名函数注入（ Closure callable Injection ）
```php
model = $model;
}
}
class Model
{
public $pdo;
public function setPdo(\PDO $pdo)
{
$this->pdo = $pdo;
}
}
$container = new Container;
$container->set(Controller::class, function () {
$pdo = new \PDO('mysql:dbname=test;host=localhost', 'root', '111111');
$model = new Model;
$model->setPdo($pdo);
return new Controller($model);
});
$controller = $container->get(Controller::class);
var_dump($controller instanceof Controller); // true
var_dump($controller->model instanceof Model); // true
var_dump($controller->model->pdo instanceof \PDO); // true
```
## 自动装配（auto wiring）
```php
bar = $bar;
$this->baz = $baz;
}
}
class Bar
{
/**
* @var \AutoWiring\Bam
*/
public $bam;
/**
* Construct.
*
* @param \AutoWiring\Bam $bam
*/
public function __construct(Bam $bam)
{
$this->bam = $bam;
}
}
class Baz
{
// ..
}
class Bam
{
// ..
}
$container = new ContainerBuilder;
$container = $container->build();
$foo = $container->get(Foo::class);
var_dump($foo instanceof Foo); // true
var_dump($foo->bar instanceof Bar); // true
var_dump($foo->baz instanceof Baz); // true
var_dump($foo->bar->bam instanceof Bam); // true
```