快速开始

环境要求

• PHP >= 8.2
• Composer
• Node.js >= 18（仅用于运行文档站点）

安装

composer require watsonhaw/lychee-php

创建入口文件

Web 入口 public/index.php

<?php

require __DIR__ . '/../vendor/autoload.php';

use Lychee\Application;

$app = new Application(
    basePath: dirname(__DIR__),
    controllerNamespace: 'App\\controller',
);

$app->run();

命令行入口 lee

#!/usr/bin/env php
<?php

require __DIR__ . '/vendor/autoload.php';

use Lychee\console\Console;
use Lychee\Application;

$app = new Application(
    basePath: __DIR__,
    controllerNamespace: 'App\\controller',
);

$console = $app->container->get(Console::class);
$console->run();

chmod +x lee

目录结构

your-app/
├── app/
│   ├── controller/    # 控制器
│   ├── model/         # 模型
│   ├── middleware/    # 中间件
│   ├── job/           # 队列任务
│   └── view/          # Twig 模板
├── config/            # 配置文件（按需创建）
├── database/
│   ├── migrations/    # 迁移文件
│   └── seeders/       # 数据填充
├── public/
│   └── index.php      # Web 入口
├── runtime/           # 运行时缓存、日志
└── lee                # 命令行入口

第一个控制器

// app/controller/HelloController.php
namespace App\controller;

use Lychee\routing\Route;

class HelloController
{
    #[Route('GET', '/')]
    public function index()
    {
        return view('hello.html', ['name' => 'Lychee']);
    }
}

{# app/view/hello.html #}
<h1>Hello, {{ name }}!</h1>

按需加载

框架仅启动 config/ 目录下存在配置文件的模块。例如：

• 创建 config/database.php → 启用数据库 ORM
• 创建 config/queue.php → 启用队列
• 创建 config/session.php → 启用会话

无需配置的模块不会被初始化。

运行

# 开发服务器
php lee run --port=8000

# 查看所有命令
php lee list

运行文档站点

cd docs
npm install
npm run docs:dev