# nano **Repository Path**: hyperf/nano ## Basic Information - **Project Name**: nano - **Description**: Nano 是一款零配置、无骨架、极小化的 Hyperf 发行版,通过 Nano 可以让您仅仅通过 1 个 PHP 文件即可快速搭建一个 Hyperf 应用。 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: https://nano.hyperf.wiki - **GVP Project**: No ## Statistics - **Stars**: 29 - **Forks**: 5 - **Created**: 2020-05-14 - **Last Updated**: 2025-06-07 ## Categories & Tags **Categories**: webframework **Tags**: None ## README [English](./README.md) | 中文

Financial Contributors on Open Collective Php Version Swoole Version Nano License

# Nano, by Hyperf Nano 是一款零配置、无骨架、极小化的 Hyperf 发行版,通过 Nano 可以让您仅仅通过 1 个 PHP 文件即可快速搭建一个 Hyperf 应用。 ## 设计理念 `Svelte` 的作者提出过一个论断:“框架不是用来组织代码的,是用来组织思路的”。而 Nano 最突出的一个优点就是不打断你的思路。Nano 非常擅长于自我声明,几乎不需要了解框架细节,只需要简单读一读代码,就能知道代码的目的。通过极简的代码声明,完成一个完整的 Hyperf 应用。 ## 特性 * 无骨架 * 零配置 * 快速启动 * 闭包风格 * 支持注解外的全部 Hyperf 功能 * 兼容全部 Hyperf 组件 * Phar 友好 ## 安装 ```bash composer require hyperf/nano ``` ## 快速开始 创建一个 PHP 文件,如 index.php 如下: ```php get('/', function () { $user = $this->request->input('user', 'nano'); $method = $this->request->getMethod(); return [ 'message' => "hello {$user}", 'method' => $method, ]; }); $app->run(); ``` 启动服务: ```bash php index.php start ``` 简洁如此。 ## 更多示例 ### 路由 `$app` 集成了 Hyperf 路由器的所有方法。 ```php addGroup('/nano', function () use ($app) { $app->addRoute(['GET', 'POST'], '/{id:\d+}', function($id) { return '/nano/'.$id; }); $app->put('/{name:.+}', function($name) { return '/nano/'.$name; }); }); $app->run(); ``` ### DI 容器 ```php getContainer()->set(Foo::class, new Foo()); $app->get('/', function () { /** @var ContainerProxy $this */ $foo = $this->get(Foo::class); return $foo->bar(); }); $app->run(); ``` > 所有 $app 管理的闭包回调中,$this 都被绑定到了 `Hyperf\Nano\ContainerProxy` 上。 ### 中间件 ```php get('/', function () { return $this->request->getAttribute('key'); }); $app->addMiddleware(function ($request, $handler) { $request = $request->withAttribute('key', 'value'); return $handler->handle($request); }); $app->run(); ``` > 除了闭包之外,所有 $app->addXXX() 方法还接受类名作为参数。可以传入对应的 Hyperf 类。 ### 异常处理 ```php get('/', function () { throw new \Exception(); }); $app->addExceptionHandler(function ($throwable, $response) { return $response->withStatus('418') ->withBody(new SwooleStream('I\'m a teapot')); }); $app->run(); ``` ### 命令行 ```php addCommand('echo', function(){ $this->get(StdoutLoggerInterface::class)->info('A new command called echo!'); }); $app->run(); ``` 执行 ```bash php index.php echo ``` ### 事件监听 ```php addListener(BootApplication::class, function($event){ $this->get(StdoutLoggerInterface::class)->info('App started'); }); $app->run(); ``` ### 自定义进程 ```php addProcess(function(){ while (true) { sleep(1); $this->get(StdoutLoggerInterface::class)->info('Processing...'); } }); $app->run(); ``` ### 定时任务 ```php addCrontab('* * * * * *', function(){ $this->get(StdoutLoggerInterface::class)->info('execute every second!'); }); $app->run(); ``` ### 使用更多 Hyperf 组件 ```php config([ 'db.default' => [ 'host' => env('DB_HOST', 'localhost'), 'port' => env('DB_PORT', 3306), 'database' => env('DB_DATABASE', 'hyperf'), 'username' => env('DB_USERNAME', 'root'), 'password' => env('DB_PASSWORD', ''), ] ]); $app->get('/', function(){ return DB::query('SELECT * FROM `user` WHERE gender = ?;', [1]); }); $app->run(); ```