Webman基础部署与运行需完成五步：一、确保PHP≥8.0并启用pcntl/posix扩展，安装Composer；二、用composer create-project或git clone创建项目并composer install；三、执行php start.php start启动服务，访问http://localhost:8787验证；四、掌握app/controller/、config/route.php、public/核心目录作用；五、新建HelloController并配置路由，访问/hello输出“Hello Webman!”。
如果您希望快速构建一个高性能PHP Web应用，但对Webman框架的初始化流程、目录结构或启动方式不熟悉，则可能是由于缺乏标准化的入门引导。以下是完成Webman基础部署与运行的关键步骤：
一、环境准备与依赖安装
Webman要求运行环境具备特定PHP版本及扩展支持，以保障异步非阻塞机制正常运作。缺失关键扩展可能导致进程无法常驻或连接异常。
1、确认PHP版本为8.0或更高版本，执行php -v验证。
2、检查是否启用pcntl、posix扩展，运行php -m | grep -E "pcntl|posix"；若无输出，需在php.ini中取消对应扩展前的分号注释并重启PHP服务。
立即学习“PHP免费学习笔记（深入）”；
3、确保已安装Composer，执行composer --version确认；未安装则前往getcomposer.org下载并全局配置。
二、项目创建与代码获取
Webman提供两种标准初始化方式，适用于不同开发习惯和网络环境，均可生成完整可运行项目结构。
1、使用Composer命令行直接创建项目：composer create-project workerman/webman。
2、通过Git克隆官方镜像仓库：git clone https://gitcode.com/gh_mirrors/we/webman，随后进入目录执行cd webman。
3、在项目根目录下运行composer install，自动拉取support、workerman等核心依赖包。
三、服务启动与端口验证
Webman采用独立进程模型，不依赖Nginx或Apache，其内置HTTP服务器通过start.php直接启动，监听默认端口用于快速验证。
1、执行php start.php start启动服务（Linux/macOS）；如需前台运行便于调试，改用php start.php start -d。
2、观察终端输出是否包含Workerman[start.php] start in DAEMON mode或Webman started successfully字样。
3、打开浏览器访问http://localhost:8787，页面显示Webman欢迎界面即表示服务已就绪。
四、核心目录结构识别
理解Webman默认目录划分有助于后续控制器编写、路由配置与中间件添加，避免文件放置错误导致加载失败。
1、app/controller/为控制器入口目录，所有用户请求处理逻辑应在此目录下新建PHP类文件。
2、config/route.php是路由注册中心，新增HTTP接口必须在此文件中调用Route::get()或Route::post()进行显式绑定。
3、public/为静态资源根目录，所有CSS、JS、图片等前端文件需存放于此，且通过/路径直接访问，例如http://localhost:8787/css/app.css。
五、首个控制器与路由联调
创建自定义响应逻辑需同时完成控制器定义与路由映射，二者缺一不可，否则将返回404错误。
1、在app/controller/下新建HelloController.php，内容包含命名空间声明与index方法：namespace app\controller; use support\Request; class HelloController { public function index(Request $request) { return response('Hello Webman!'); } }。
2、编辑config/route.php，在文件末尾添加路由规则：Route::get('/hello', [app\controller\HelloController::class, 'index']);。
3、保存后刷新浏览器访问http://localhost:8787/hello，页面应显示纯文本Hello Webman!。
