# console

**Repository Path**: fiberphp/console

## Basic Information

- **Project Name**: console
- **Description**: ⌨️ FiberPHP 命令行组件 —— 自研轻量级 CLI 工具，支持命令自动发现、参数解析，零外部依赖，开箱即用。
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-22
- **Last Updated**: 2026-09-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FiberPHP Console

自研 CLI 应用（不依赖 Symfony Console），提供命令解析、分发、交互式输入输出与服务器控制。

## 环境要求

- PHP >= 8.3
- `composer-runtime-api` ^2.0（`version` 命令读取包版本）

## 安装

```bash
composer require fiberphp/console
```

## 入口

`fiberphp` CLI 入口由安装钩子在 `composer install/update` 时自动发布到项目根目录（幂等，已存在不覆盖），无需手动创建：

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

declare(strict_types=1);

use FiberPHP\Console\Application;

const BASE_PATH = __DIR__;

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

Application::start();
```

## 内置命令

| 命令 | 说明 |
|---|---|
| `start` | 启动 Worker（DEBUG 模式，`-d` 进入 DAEMON 模式） |
| `stop` / `reload` / `restart` | 停止 / 平滑重载 / 重启 Worker |
| `status` / `connections` | 查看进程状态 / 连接列表 |
| `config:cache` / `config:clear` | 配置缓存构建与清除 |
| `optimize:cache` / `optimize:clear` | 全部优化缓存构建与清除（配置、路由、事件监听器、包清单） |
| `package:discover` | 重建包发现清单 |
| `version` | 输出框架版本 |

## 命令优先级

后注册者按命令名覆盖前者：

1. `PackageManifest::commands()`（包发现 + `config/command/*.php` 扫描）
2. `config('commands')` 应用显式声明（最高）

## License

[MIT](LICENSE)